% arabdocc.tex %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section {Release history}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\let < \bra

There was a Version 1 which is no more supported.

Version 2 was not fully compatible with Version 1;
however, moving to the new version usually caused little problems.
Apart from some extensions, most changes were introduced
in order to better conform to the transliteration standards,
and to have less compatibility problems with \TeX\ and \LaTeX.
Further versions are expected to be upward compatible
if no serious problems will turn up.

The main differences between versions 1 and 2 are:

\begin{itemize}

\item The font size has increased, so the document layout may change.
  The old font {\tt "nash10"} can no more be used as the character locations
  have been assigned differently.
                                                  \index{font!nash10}
                                                  \index{font!nash14}

\item Some Arabic characters are now coded differently:
  \ain\ is denoted by a left quote,
  and <c>, <^z>, <^t>, and <.n> have been assigned new meanings
  in order to better conform to the standard transliteration.
                                                  \index{coding conventions}

\item There are many more ligatures than before.
  This normally need not concern the user.
                                                  \index{ligature}

\item \verb+\vocalize+ will no more generate \sukun\ and \wasla\
  except if explicitly indicated by quoting. See \verb+\fullvocalize+.
                                                  \index{\vocalize}
                                                  \index{.\sukun}
                                                  \index{.\wasla}
                                                  \index{\fullvocalize}

\item Arabic Environments are now always bracketed
  by the new control sequences
  \verb+\begin{arabtext}+ and \verb+\end{arabtext}+
  even if only the transliteration is wanted.
                                                  \index{\begin{arabtext}}
                                                  \index{\end{arabtext}}
                                                  \index{transliteration}

\end{itemize}

We strongly recommend converting any still existing version 1 input files 
to the new notation.
To assist in this migrating procedure, the \LaTeX\ option {\tt "oldarabtex"}
and/or the command \verb"\oldarabtex" will switch to a mode
where virtually all places where the old conventions are used,
will either produce a \TeX\ error message or will be flagged in the output.
%This shortcut will probably go away in some future version.
                                                  \index{option!oldarabtex}
                                                  \index{\oldarabtex}

The changes introduced since the release of Version 2.00 up to now
(Version 3.00) % <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
fall into one of two categories:
error corrections, and upward compatible extensions.
Details are not given here, but are documented in the text file CHANGES
that is part of the distribution package of \ArabTeX.

Version 3 is upwards compatible with version 2.
All supported features are documented in this manual.


\let < \oldbra

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