% arabdoc8.tex %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section {Miscellaneous features}\label{misc}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


%-------------------------------------------------------------------------
\subsection {Automatic stretching}
%-------------------------------------------------------------------------

  For special purposes, e.g. for headlines and for
  Arabic paragraphs containing long mathematical or non-Arabic insertions,
  the connection between adjacent Arabic letters may be made ``elastic'',
  if they form no ligature.
  Thus a \kashida\ is inserted whose length will be adjusted
  automatically to uniformly fill the output line.
                                                  \index{automatic stretching}
                                                  \index{stretching}
                                                  \index{stretching!automatic}
                                                  \index{.\kashida}

  This feature very easily leads to storage overflow during the processing,
  and should only be used whenever necessary.
  It is switched on with \verb"\spreadtrue"
  and switched off again with \verb"\spreadfalse".
  Inside an {\em Arabic Environment,} 
  it will also be switched off automatically
  at the end of every paragraph.
                                                  \index{\spreadtrue}
                                                  \index{\spreadfalse}
  
%-------------------------------------------------------------------------
\subsection {Dots on \yah}
%-------------------------------------------------------------------------

Whether \yah\ in the final position carries dots or not
  is controlled by the chosen language convention.
  You can override this, after selecting the language,
  by \verb"\yahdots" and \verb"\yahnodots".
                                                  \index{\yahdots}
                                                  \index{dots on \yah}
                                                  \index{.\yah!dots}
                                                  \index{\yahnodots}

%-------------------------------------------------------------------------
\subsection {Additional codings}
%-------------------------------------------------------------------------

To reproduce exotic, erroneous or archaic texts exactly as they are written,
  some additional codings are available, see Table~\ref{special}.
                                                  \index{archaic text}
                                                  \index{text!archaic}
                                                  \index{text!erroneous}
                                                  \index{special codings}

\begin{table}[htb]
\begin{center}
\setarab
\begin{tabular}{|r|c|c|l|}
\hline    \astrut
\atabii  .k   {\kaf\ in the final position without a mark}
\\ \hline \astrut
\atabii  ^d   {\dal\ with a dot below}
\\ \hline \astrut
\atabii  .f   {\fah\ without a dot}
\\ \hline \astrut
\atabii  .b   {\bah\ without a dot}
\\ \hline \astrut
\atabii  .n   {\nun\ without a dot (not available in Pashto mode)}
\\ \hline \astrut
\atabii   Y   {\alif\ \maqsura; \yah\ without dots in all positions}
\\ \hline
\end{tabular}
\end{center}
\caption{Additional codings for special purposes.}
\label{special}
\end{table}

\newpage
If further variants are needed, write to the author and indicate:

\begin{itemize}
\item the required shape,
\item the assumed transliteration,
\item a suggestion for the input coding,
\item some information on the intended use.
\end{itemize}

We are willing to consider any suggestion. 
Adding a new character might be easy, or else it might be impossible.
\ArabTeX\ is flexible, but there are some technical limitations.

%-------------------------------------------------------------------------
\subsection {Progress report}
%-------------------------------------------------------------------------

As \ArabTeX\ is slow,
  it will produce some terminal output while running
  to indicate it is still alive.
  If that is not wanted, e.g., on a very fast system, 
  or while running a batch job,
  say \verb"\quiet" or \verb"\tracingarab = 0"
  (outside an {\em Arabic Environment};
  otherwise say \verb"\doassign {\tracingarab }{0}").
  \verb"\tracingarab = 1" will only report Arabic paragraphs,
  a value of~2: Arabic lines and insertions,
  a value of 3 or~more: individual {\em Arabic items}.
                                                  \index{\quiet}
                                                  \index{\tracingarab}

\newpage
%-------------------------------------------------------------------------
\subsection {Verbatim copy of the input}
%-------------------------------------------------------------------------

For test purposes, the Arabic input may be reproduced verbatim
after \verb/\showtrue/ in addition to the normal output;
\verb/\showfalse/ switches this feature off again.
Commands will not usually be shown.
The output will generally not look pleasant,
and this feature is only provided in order to trace down errors,
or to demonstrate the operation of \ArabTeX\ as in the appendix.
                                                  \index{\showtrue}
                                                  \index{\showfalse}

%-------------------------------------------------------------------------
\subsection{Using \ArabTeX\ with EDMAC}
%-------------------------------------------------------------------------

\ArabTeX\ will cooperate with EDMAC, a Plain \TeX\ macro package
for critical editions, written by John Lavagnino and Dominik Wujastyk.
If EDMAC is already present when \ArabTeX\ is loaded, the EDMAC commands
%
will, after suitable modifications, be available inside an
{\em Arabic environment.} Their arguments are considered Roman text
but may contain {\em Arabic quotations.} 
                                                  \index{EDMAC}

For further details, see the EDMAC documentation.

\iffalse
%-------------------------------------------------------------------------
\subsection {Code conversion}
%-------------------------------------------------------------------------

(to be written, and implemented)
\fi

\endinput
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%