diff options
| -rw-r--r-- | Master/texmf-dist/doc/latex/arabtex/arabtex-doc.pdf | bin | 0 -> 270366 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/arabtex/arabtex.htm | 29 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/arabtex/changes.txt | 368 | ||||
| -rw-r--r-- | Master/texmf-dist/tex/latex/arabtex/arabtex-doc.tex | 568 | ||||
| -rwxr-xr-x | Master/tlpkg/libexec/ctan2tds | 9 |
5 files changed, 970 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/arabtex/arabtex-doc.pdf b/Master/texmf-dist/doc/latex/arabtex/arabtex-doc.pdf Binary files differnew file mode 100644 index 00000000000..0a550378e52 --- /dev/null +++ b/Master/texmf-dist/doc/latex/arabtex/arabtex-doc.pdf diff --git a/Master/texmf-dist/doc/latex/arabtex/arabtex.htm b/Master/texmf-dist/doc/latex/arabtex/arabtex.htm index e929d4e3896..be97c69f046 100644 --- a/Master/texmf-dist/doc/latex/arabtex/arabtex.htm +++ b/Master/texmf-dist/doc/latex/arabtex/arabtex.htm @@ -11,6 +11,12 @@ <a href="http://129.69.218.213/arabtex/doc/arabtex/html/changes.htm"> Last changes: Version 3.11s, July 02, 2006 </a> +<p> +<img src="new1.gif" alt="new"> +There is also a prototype of +<a href="http://129.69.218.213/arab312/doc/arabtex/html/changes.htm"> +Version 3.12, July 06, 2006 +</a> <hr><!-- ================================================ --> @@ -227,7 +233,7 @@ will produce a current status report. Prof. Klaus Lagally<br> Institut fuer Formale Konzepte der Informatik<br> Universitaet Stuttgart<br> - Universitaetsstrasse 20-22<br> + Universitaetsstrasse 38<br> D-70569 Stuttgart<br> GERMANY<br> lagally@informatik.uni-stuttgart.de @@ -238,3 +244,24 @@ will produce a current status report. Klaus Lagally </a> <hr> </body></html> + + + + + + + + + + + + + + + + + + + + + diff --git a/Master/texmf-dist/doc/latex/arabtex/changes.txt b/Master/texmf-dist/doc/latex/arabtex/changes.txt index 9bb3a84f312..30fbf5ac8a8 100644 --- a/Master/texmf-dist/doc/latex/arabtex/changes.txt +++ b/Master/texmf-dist/doc/latex/arabtex/changes.txt @@ -1,4 +1,4 @@ -CHANGES.TXT 23.10.2003 +CHANGES.TXT 02.07.2006 -------------------------------------------------------------------------- ArabTeX Version 3 ================= @@ -32,6 +32,370 @@ CHANGES.TXT 23.10.2003 even major versions. We can make them available on request, but you should have good reasons, and there will be no support. +========================================================================== +02.07.2006: Version 3.11s + + Fixes: + + - In mixed paragraphs, the handling of horizontal spacing between + Arabic insertions and Roman text, and vice versa, is determined + by the spaces (if present) in the input text inside and outside + of the RL{} commands. + + New features: + + - The experimental package "saw.sty" provides macros \SAW and \ALS + for producing special glyph combinations for theological and + religious texts (with the exception of the Holy Qur'an, which we + do not support). These macros work inside and outside of Arabic + mode; presently they are available in \normalsize only. + + Note: + + - We are informed of a project, within the Muslim world, to extend + ArabTeX by special features for printing the Holy Qur'an. We + know about the difficulties, and we wish them success. + + Installation: + + - download "apatch.sty" and, if required, "saw.sty". + +-------------------------------------------------------------------------- +17.04.2006: Version 3.11r + + Fixes: + + - A glitch in EDMAC mode was fixed. + + - <Roman insertions> within Arabic text work again, also when the + <shorthand> notation for Arabic insertions in Roman text is in + force. + + New features: + + - Processing of bidirectional paragraphs has been reimplemented + completely. Roman paragraphs with Arabic script insertions may + have arbitrary, variable '\parshape's and even nested recursive + insertions to arbitrary depth. This is rarely needed, but it is + a strong torture test for the new algorithm. + + - With LaTeX, the package 'lineno.sty' for producing line numbers + is now fully supported. The former restrictions no more apply. + + Installation: + + - download "apatch.sty" and also "alocal.sty". + +-------------------------------------------------------------------------- +01.03.2006: Version 3.11q + + Fixes: + + - Some more incompatiblities with Plain TeX have been fixed. + + - Vertical spacing commands in LaTeX work better within Arabic + environments. + + New features: + + - A new file "alocal.sty" was introduced in order to facilitate + loading local extensions for individual users. Normally it + does nothing, but must be present. + + - There is some limited support for users of "lineno.sty"; if + that package is present, line numbers will work in the basic + \linenumber mode within Arabic environments, and \linelabel + can also be used. Other features have not been tested. + + CAUTION: The command \RL{} is presently not quite compatible + with the "lineno.sty" package, and might break, both itself + and the line numbers! In that case, try \< > for insertions. + + Installation: + + - download "apatch.sty" and also "alocal.sty". + +-------------------------------------------------------------------------- +08.02.2006: Version 3.11p + + Fixes: + + - There was an incompatibility between the patching mechanism in + "apatch.sty" and Plain TeX (only!). + + - Final "ha'" in Jawi had the wrong shape. + + New features: + + - There is an improved version of "verses.sty"; for documentation + see the file itself. + + Installation: + + - download "apatch.sty" and, if required, "verses.sty". + +-------------------------------------------------------------------------- +01.02.2006: Version 3.11o + + Fixes: + + - The lines of a bidirectional paragraph were sometimes mixed up + when a page break interfered. This was neither easy to find nor + to fix. + + - An incompatible (!) change in Plain TeX 3.1415926 had broken the + transcription module. Use of ArabTeX with LaTeX was not affected. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +06.04.2005: Version 3.11n + + Fixes: + + - In the Arabic document classes the commands 'figure' and 'table' + were broken. They work again. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +23.01.2005: Version 3.11m + + Fixes: + + - In the Arabic document classes the list environments were + broken. Their labels work again. + + - Punctuation marks in the Arabic script have been moved down + slightly. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +24.06.2004: Version 3.11l + + Fixes: + + - An incompatibility between Kashmiri mode and Hebrew mode was + taken care of. A small glitch in Uighuric mode was fixed. + + - Arabic and Hebrew (right to left) insertions in a left-to-right + paragraph now also work correctly within LaTeX table fields + specified with the p{} qualifier. + + New features: + + - The skip values \LRskip {\hskip \z@ plus 0.1em } before a RTL + insertion, and \RLskip {\hskip \z@ plus 0.1em } after a RTL + insertion, may be adjusted by the user to tune the appearance + of bidirectional paragraphs. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +24.05.2004: Version 3.11k + + Fixes: + + - Arabic and Hebrew (right to left) insertions in a left-to-right + paragraph now also work correctly at the very beginning of the + paragraph, and also in the context of nested LaTeX environments. + There used to be spurious spaces and shifted baselines. + + Note: + + - the reading modules 'bhs.sty', 'witbhs.sty', and 'buck.sty' + presently cannot coexist with other input encoding methods for + Arabic and Hebrew, not even with the standard transliteration + encoding. This restriction might go away in further versions. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +17.05.2004: Version 3.11j + + Fixes: + + - The unconditional placement of a 'hamza' mark on a character + by the suffix < " ' > had been disabled for internal reasons. + It is active again. + + - In Hebrew mode, the placement of diacritics within a final kaph + letter was fixed again. This had already been corrected in the + version 3.11d, but that patch did not work. + + New features: + + - The experimental reading module 'buck.sty' for the 'Buckwalter' + encoding conventions has been upwards compatibly extended to + cover XML compatible extensions, several Persian letters, and + new encodings of diacritic marks as proposed by the Archimedes + project. For details and open issues, enquire. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +26.04.2004: Version 3.11i + + Fixes: + + - The algorithm for bidirectional line-breaking in mixed Arabic- + Roman paragraphs has been completely re-implemented. It is now + shorter and faster, and hopefully, has fewer bugs. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +15.03.2004: Version 3.11h + + Fixes: + + - For Pashto and Sindhi modes, and also for special purposes, + a few input encodings have been changed to conform with the + new version of the user manual (still in preparation). + + New features: + + - For YIVO Yiddish, a few additional input encodings have been + provided to write Hebrew words according to the conventions + of the "Yiddishe Shraybmashinke" by Refoyl Finkel. + + - In 'verses.sty' the command \setversedim {length}{gap} to set + the length of the halfverses and their separation, has been + expanded to the format \setversedim {length1}[length2]{gap} by + an optional second (!) argument to set the lengths of the + two hemistichs independently. The old format still works. + The command \halfverses {first}[conn]{second} is equivalent to + \connverses {first}{conn}{second} (mind the brackets!) + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +26.02.2004: Version 3.11g + + Fixes: + + - When the Arabic Windows encoding is used, double quotes <"> + are interpreted as directional quotes <``> and <''> according + to the context. + + - When using 'verses.sty' the text will be centered, both in + Plain TeX mode and in LaTeX mode. Whenever this is not feasible + due to the indicated verse dimensions, hemistichs will be put + flush right and flush left in alternate lines. Connecting the + hemistichs in that case is not possible; end the last word of + the first hemistich, and start the first word of the second, + by a dash <-> to get the connecting forms of the appropriate + letters, if they exist. + + New features: + + - Within an Arabic word in transliteration encoding, a plus sign + <+> will unconditionally place a 'sukun' or, after an initial + 'alif', a 'wasla', on the preceding letter. As the first + character, or isolated or after punctuation, the plus sign + denotes itself. + + - In Sindhi mode, the special ending 'in' as in <min> and <'in> + may also be coded <.mIN> and <'IN>. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +12.02.2004: Version 3.11f + + Fixes: + + - Some character assignments for Judeo-Arabic were corrected. + + - Various minor technical bugs were found and corrected. + + New features: + + - The file 'arabwin.sty' is obsolete and should no more be used; + for the Arabic Windows encoding use 'cp1256.sty' instead. The + encoding is set by '\setcode{cp1256}' or '\setcode{arabwin}'. + + - In pausal position, the feminine ending <aT> (tah marbuta) is + now transcribed as 'ah'. The input encoding is unchanged. + + Installation: + + - download "apatch.sty". + +-------------------------------------------------------------------------- +08.12.2003: Version 3.11e + + Fixes: + + - Bidirectional paragraphs are now handled correctly even within + the LaTeX environments 'quote' and 'quotation'. + + - In Hebrew mode, the positioning of 'nikudot' on final 'kaph' + was improved. + + - The handling of final 'Urdu wavy hah' was improved. + + - After switching the font size in LaTeX (also implicitly in + section titles and such), an initial number sometimes was + lost even outside of Arabic or Hebrew mode. This has been + corrected. + + New features: + + - The font 'xnsh14' is the default for Arabic mode. In Hebrew + mode, 'hclassic' is the default. + + - ArabTeX now seems to be compatible with 'inputenc.sty'. + + - In the Unicode mode, additional extended Arabic characters + are now supported, so are ZWJ = ZERO WIDTH JOINER and ZWNJ + = ZERO WIDTH NON-JOINER (see below). + + - 'dotless bah' and 'Uzbek ae' are supported in Unicode mode. + + - Within an Arabic word in transliteration encoding, a star <*> + will unconditionally place a 'shadda' on the preceding letter. + At the beginning of a word, or isolated or after punctuation, + the star denotes itself. + + Notes: + + - Changes of input encoding are \global for technical reasons. + + - Private reading modules for individual users may be broken + by the new reading strategy introduced for compatibility with + 'inputenc.sty'. In case of problems, contact the author. New + versions of 'buck.sty, 'bhs.sty', and 'witbhs.sty' have been + prepared. + + Open issues: + + - The space introduced by ZWNJ = ZERO WIDTH NON-JOINER is still + too wide. No fix is known. + + Installation: + + - download "apatch.sty". + -------------------------------------------------------------------------- 23.10.2003: Version 3.11d @@ -2069,6 +2433,6 @@ CHANGES.TXT 23.10.2003 lagally@informatik.uni-stuttgart.de FAX: +49 - 711 - 7816 370 -------------------------------------------------------------------------- - Copyright (c) 1990 - 2003, Klaus Lagally + Copyright (c) 1990 - 2006, Klaus Lagally -------------------------------------------------------------------------- diff --git a/Master/texmf-dist/tex/latex/arabtex/arabtex-doc.tex b/Master/texmf-dist/tex/latex/arabtex/arabtex-doc.tex new file mode 100644 index 00000000000..7fcd116a628 --- /dev/null +++ b/Master/texmf-dist/tex/latex/arabtex/arabtex-doc.tex @@ -0,0 +1,568 @@ +\documentclass[pagesize=auto]{scrartcl} + +\usepackage{fixltx2e} +\usepackage{xspace} +\usepackage{lmodern} +\usepackage{mflogo} +\usepackage[T1]{fontenc} +\usepackage{textcomp} +\usepackage{array} +\usepackage{booktabs} +\usepackage{microtype} +\usepackage{hyperref} + +\newcommand*{\ArabTeX}{Arab\kern-0.12em\TeX\@\xspace} +\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle} +\newcommand*{\symb}[1]{\textsf{\textlangle#1\textrangle}} + +\pdfstringdefDisableCommands{% + \def\ArabTeX{ArabTeX\xspace}% + \def\meta#1{<#1>}% + \def\symb#1{<#1>}% +} + +\newenvironment{codetable}[1]{% + \catcode`\"=12 + \catcode`\'=12 + \catcode`\`=12 + \catcode`\_=12 + \catcode`\^=12 + \catcode`\~=12 + \par + \nopagebreak + \medskip + \noindent + \quitvmode + \tabular{@{}*{\numexpr#1-1\relax}{I@{\qquad}}I@{}}% +}{% + \endtabular + \par + \medskip +} + +\newcolumntype{I}{>{\ttfamily}r@{\hspace{0.6em}}l} + +\title{The \ArabTeX package} +\author{Klaus Lagally} +\date{20.11.1993} + + +\begin{document} + +\maketitle + +\tableofcontents + +\section{\ArabTeX Version~3 (20.11.1993)} + +The introduction below is slightly out of date +but may be used as a first start. + + +\section{\ArabTeX Version~2 (05.11.1992)} + +\subsection{What is \ArabTeX?} + +\ArabTeX is a package extending the capabilities of \TeX/\LaTeX\ to generate +the arabic writing from an ASCII transliteration for texts in several +languages using the arabic script. + +It consists of a \TeX\ macro package and an arabic font in several sizes, +presently only available in the Naskhi style. \ArabTeX will run with Plain +\TeX\ and also with \LaTeX; other additions to \TeX\ have not been tried. + +\ArabTeX is primarily intended for generating the arabic writing, but the +scientific transcription can be also easily generated. For other languages +using the arabic script limited support is available. + + +\subsection{Installing \ArabTeX:} + +The installation procedure is system dependent. You have to install the +``\textsf{nash14}'' font with its ``\texttt{*.pk}'' and ``\texttt{*.tfm}'' files on the font search path of +your \TeX\ system, and the ``\texttt{*.sty}'' files and ``\texttt{arabtex.tex}'' on the source +search path of your system. Possibly you will have to rename the ``\texttt{*.pk}'' +files according to local conventions, and as a last resort you can try to +recreate the font from the ``\texttt{*.mf}'' \MF\ sources. Additional fonts if +available are installed analogously. + + +\subsection{Activating ArabTeX:} + +With Plain \TeX, load the ArabTeX macros by ``\verb+\input arabtex+''.\@ With \LaTeX, +include the option ``\texttt{arabtex}'' in the document header. In both cases several +additional files will be loaded automatically. + +\ArabTeX defines several additional commands as indicated below, and also a +large number of internal commands which could lead to storage overflow in +a small TeX implementation. All internal commands contain an ``at'' sign \texttt{<@>} +in their names and thus should not interfere with any user defined +commands (but possibly with \TeX\ extensions we do not know about). + +With Plain \TeX, the arabic font is only available at the normal 14~point +size which ought to cooperate well with the ``\textsf{cm}'' fonts at 10~points. For +other sizes, change the ``\verb+\magnification+'' or define additional font +identifiers yourself. To change the default, inspect ``\texttt{arabtex.tex}'' and +redefine the ``\verb+\pnash+'' command accordingly. With \LaTeX, the size changing +commands will also operate on the arabic font. + + +\subsection{Input to ArabTeX:} + +After activating \ArabTeX, your modified \TeX/\LaTeX\ system will recognize +the following items: +% +\begin{itemize} +\item normal \TeX/\LaTeX\ text and commands, +\item short arabic quotations bracketed by \verb+<+ and \verb+>+; these must fit on one + line of output, and you have to select one of the Arabic writing styles, + e.g \verb+\setarab+, before using this feature. A quotation may also be started + with \verb+\<+. +\item longer arabic texts bracketed by \verb+\begin{arabtext}+ and \verb+\end{arabtext}+, + called ``Arabic Environments'' in the sequel. +\end{itemize} + +An Arabic Environment consists of one or several paragraphs separated by +blank lines or \verb+\par+ commands. Every paragraph and every arabic quotation +is a sequence of the following kinds of items, separated by blank spaces +or newlines: +% +\begin{itemize} +\item isolated (legal) special characters, interpreted as the corresponding + arabic special character; +\item ``numbers'', character sequences starting with a digit. A ``number'' will be + translated in the normal writing sequence from left to right even if it + contains letters and/or special characters; +\item ``arabic quotes'', coded as two left quotes or two right quotes each; +\item ``words'', character sequences starting with a letter or special character + followed by a letter. The (coded) characters of a word will in the + output be arranged from right to left. +\item \TeX/\LaTeX\ control sequences WITHOUT parameters. These will be executed + immediately. +\item \ArabTeX control sequences with or without parameters. These will be + executed immediately. +\item a sequence of items enclosed in curly braces \verb+{+ and \verb+}+. The output from + the constituents will be arranged from right to left and must fit on one + output line. As far as \TeX\ is concerned, this is NO group. This feature + may not be nested. +\end{itemize} + +Output from all items will be arranged from right to left, lines will be +broken as necessary. + +Inside an Arabic Environment, but NOT in an arabic quotation, you may also +have: + +\begin{itemize} +\item short mathematical insertions, bracketed by SINGLE \verb+$+ signs. They must + fit on one output line and are processed as usual; +\item short non-arabic text quotations, bracketed by \verb+<+ and \verb+>+. These must fit + on one output line and introduce a new level of grouping, so if they + contain any \TeX/\LaTeX\ assignments the effects of these will be local. +\end{itemize} + +Control sequences in an Arabic Environment may be of the following kinds: + +\begin{itemize} +\item \ArabTeX option changing commands. These may also be used outside an + Arabic Environment and generally have a global effect; +\item \verb+\\+ for a new line; +\item \verb+\par+ (or a blank line) for a new paragraph, \verb+\noindent+ for a new paragraph + without indentation (NOT in arabic quotations); +\item \verb+\emphasize+ \meta{item} will put a bar over the next \meta{item}; +\item \verb+\setnash+, \verb+\setnashbf+, \verb+\setnastaliq+ font selection commands, see below; +\item size changing \LaTeX\ commands like \verb+\large+ etc., only if you use \LaTeX; +\item most other \TeX/\LaTeX\ commands make no sense in an Arabic Environment. +\item you MUST NOT nest another \LaTeX\ environment inside an Arabic Environment + (except possibly display math which we did not test, and might work); +\item if you really need to use a control sequence with parameters, define a + new \TeX\ macro or enclose the whole construct in curly braces \verb+{+ and \verb+}+. +\end{itemize} + + +\subsection{Font selection:} + +For space economy, only the \textsf{Naskh} font is available by default. With \LaTeX, +additional fonts can be loaded by the document style options ``\texttt{nashbf}'' +and/or ``\texttt{nastaliq}'' (when available). Users of Plain \TeX\ can load and define +suitable fonts themselves. + +The following font selection commands are available: + +\begin{itemize} +\item \verb+\setnash+ (default) selects the \textsf{Naskh} font. +\item \verb+\setnashbf+ selects a bold-face version of \textsf{Naskh}. +\item \verb+\setnastaliq+ selects the \textsf{Nastaliq} font. +\end{itemize} + +If a font is not available or has not been loaded, the corresponding +command will select the default font. + +With \LaTeX, the size changing commands will also operate on the additional +fonts. + + +\subsection{Input coding:} + +The ASCII input notation for arabic text is modelled closely after the +transliteration standards ISO/R\,233 and DIN\,31\,635. As these standards do +not guarantee unique re-transliteration and are also not ASCII compatible, +some modifications were necessary. These follow the general rules: +% +\begin{itemize} +\item if the transliteration uses a single letter, code that letter; +\item if the transliteration uses a letter with a diacritical mark, put a + special character similar to the diacritical mark BEFORE the letter. +\end{itemize} + + +\subsubsection{Additional characters generally available:} + +\begin{codetable}{6} + b & bah & d & dal & .s & ssad & f & fah & h & hah & ' & hamza \\ + t & tah & _d & dhal & .d & ddad & q & qaf & w & waw & N & tanween \\ + _t & thah & r & rah & .t & ttah & k & kaf & y & yah & Y & alif maqsoura \\ + ^g & geem & z & zay & .z & tthah & l & lam & g & gaf & _A & alif maqsoura \\ + .h & hhah & s & seen & ` & `ain & m & meem & p & pah & T & tah marbouta \\ + _h & khah & ^s & sheen & .g & ghain & n & noon & v & vah & W & waw (see below) +\end{codetable} + + +\subsubsection{Standard arabic and persian characters:} + +\begin{codetable}{1} + c & hhah with hamza \\ + ^c & gim with three dots (below) \\ + ,c & khah with three dots (above) \\ + ^z & zay with three dots (above) \\ + ~n & kaf with three dots (Ottoman) \\ + ~l & law with a bow accent (Kurdish) \\ + ~r & rah with two bows (Kurdish) +\end{codetable} + +See also ``Urdu'' and ``Pashto'' below. + + +\subsubsection{Additional coding rules:} + +\begin{itemize} +\item For long vowels, use capital letters \verb+A+, \verb+I+, \verb+U+, or \verb+_a+, \verb+_i+, \verb+_u+. +\item As the transliteration is ambiguous, use \verb+T+ for \symb{tah marbouta}, + \verb+N+ for \symb{tanween}, \verb+Y+ or \verb+_A+ for \symb{alif maqsoura}. +\item Short vowels \verb+a+, \verb+i+, \verb+u+ need not generally be written except in the + following cases: + \begin{itemize} + \item at the beginning of a word where they generate \symb{alif}, + \item adjacent to \symb{hamza} where they will influence the carrier, + \item when the transcription is wanted, + \item in \verb+\fullvocalize+ mode. + \end{itemize} +\item \symb{hamza} is denoted by a single RIGHT quote; its carrier will be + determined from the context according to the rules for writing arabic + words. If that is not wanted, ``quote'' it (see below). +\item \symb{`ain} is a single LEFT quote, don't confuse it with \symb{hamza}! +\item \symb{madda} is generated by a right quote (\symb{hamza}) before \verb+A+: \verb+'A+. +\item The ``invisible letter'' \verb+|+ may be inserted in order to break unwanted + ligatures and to influence the \symb{hamza} writing. It will not show in the + arabic output or in the transcription. +\item \symb{tashdid} is indicated by doubling the appropriate letter. +\item The article is always written \verb+al-+ (with hyphen!). +\item Hyphens \verb+-+ may be used freely, and generally do not change the writing, + but will show up in the transcription. At the beginning and the end of a + word they enforce the use of the connection form of the adjacent letter + (if it exists), like e.g. in the date \verb+1400 h-+. +\item A double hyphen \verb+--+ between two otherwise joining letters will break + any ligature and will insert a horizontal stroke (\symb{tatweel}, \symb{kashida}) + without appearing in the transcription. It may be used repeatedly. +\end{itemize} + + +\subsection{Quoting:} + +A double quote \verb+"+ will modify the meaning of the following character as +follows: +% +\begin{itemize} +\item if a short vowel follows, the appropriate diacritical mark \symb{fatha}, + \symb{kasra}, \symb{damma} will be put on the preceding character even if the + vocalization is off otherwise. If \verb+N+ follows the short vowel, the + appropriate form of \symb{tanween} will be generated instead. At the + beginning of a word, \symb{alif} is assumed as the first character. If the + previous word ended with a vowel, \symb{wasla} is generated instead of the + vowel indicator. +\item if the following character is a single right quote, a \symb{hamza} mark will + be put on the preceding character even if in conflict with the \symb{hamza} + rules. +\item if the following character is the ``invisible letter'' \verb+|+, the connection + between the adjacent letters will be broken and a small space inserted. +\item otherwise: a \symb{sukun} will be put on the preceding character. The + following character will be processed again. +\end{itemize} +% +The double quote will not show up in the transcription. + + +\subsection{Ligatures:} + +There is no way to explicitly indicate ligatures as a large number of them +are generated automatically. Any unwanted ligature can be suppressed by +interposing the invisible letter \verb+|+ between the two letters otherwise +combined into a ligature. After ``\verb+\ligsfalse+'' ligatures in the middle of a +word will not normally be produced; for some texts this looks better. You +can return to the normal strategy by ``\verb+\ligstrue+''. + + +\subsection{Vocalization:} + +There are three modes of rendering short vowels: +% +\begin{labeling}{\texttt{\string\fullvocalize}:} +\item[\texttt{\string\fullvocalize}:] + \begin{itemize} + \item every short vowel will generate the corresponding diacritic mark + \symb{fatha}, \symb{kasra}, \symb{damma}. + \item If \verb+N+ follows a short vowel, the corresponding form of \symb{tanween} is + generated instead. + \item \verb+_a+ will produce a \symb{qur'an alif} accent instead of an explicit + \symb{alif} character which is coded \verb+A+. + \item if a long vowel follows a consonant, the corresponding short vowel is + implied. The long vowel itself carries no diacritical mark. + \item if no vowel is given after a consonant, \symb{sukun} will be generated + except if a double ``sun letter'' follows \symb{lam}. + \item \symb{alif} at the beginning of a word carries \symb{wasla} instead of the vowel + indicator if the preceding word ended with a vowel. + \end{itemize} +\item[\texttt{\string\vocalize}:] as above, but \symb{sukun} and \symb{wasla} will not be generated except + if explicitly indicated by ``quoting''. +\item[\texttt{\string\novocalize}:] no diacritics will be generated except if explicitly asked for + by ``quoting''. +\end{labeling} +% +In all modes, a double consonant will generate \symb{tashdid}, and \verb+'A+ always +generates \symb{madda} on \symb{alif}. After \verb+aN+ the silent \symb{alif} character is +generated if necessary. The silent \symb{alif} may also be explicitly indicated +by \verb+aNa+ or \verb+aNA+, or coded literally as \verb+A+ in \verb+\novocalize+ mode. If a +silent \symb{alif maqsoura} is wanted instead, write \verb+aNY+, \verb+aN_A+, \verb+Y+ or \verb+_A+. +A silent \symb{alif} after \symb{waw} is indicated by \verb+Ua+, \verb+UA+ or \verb+Wa+, \verb+WA+ (with +a capital \verb+W+!). + + +\subsection{Transcription:} + +In addition to the arabic writing, the standard scientific transcription +may also be obtained from a fully vocalized input text. This is indicated +by ``\verb+\transtrue+'' and may be switched off again by ``\verb+\transfalse+''. If ONLY +the transcription is wanted, you can deactivate the arabic writing by +``\verb+\arabfalse+''; it can be reactivated by ``\verb+\arabtrue+''. If both modes are +active their output will be interleaved line by line. + +The transcription mode assumes that the input text is in the Arabic +language and has been coded according to the rules given above. For words +from other languages the transcription might be in error. For Arabic text, +the following special cases are handled: +% +\begin{itemize} +\item after the article, a double consonant will be assimilated; +\item an initial vowel will be omitted if the preceding word ended with a + vowel. If that is not wanted start with \symb{hamza}. +\item a silent \symb{alif} or \symb{alif maqsoura} after \verb+N+ (\symb{tanwin}) and \verb+U+ is + omitted in the transcription. The same happens after \symb{waw} if it is + written \verb+W+. +\end{itemize} + +For space economy, the transcription module is NOT loaded by default. If +you want to use it, add the style option ``\texttt{atrans}'' with \LaTeX; and with +Plain \TeX, say ``\verb+\input atrans.sty+''. + + +\subsection{Support for other languages:} + +\ArabTeX is primarily intended for writing texts in classical and modern +Arabic, but it also provides limited support for several other languages +that are customarily written in the arabic alphabet. The vocalization and +the transcription cannot generally be expected to be correct, but might +work by accident. + +In order to switch to the conventions for one of these languages, say +``\verb+\setfarsi+'', ``\verb+\seturdu+'', ``\verb+\setpashto+'', ``\verb+\setmaghribi+''; ``\verb+\setarab+'' is the +default and can also be used to switch back to the arabic conventions. + + +\subsubsection{Farsi, Dari:} + +All characters needed for writing Farsi are available by default. The +short vowels \verb+e+ and \verb+o+ are mapped to \symb{i} and \symb{u}, the long vowels \verb+E+ +and \verb+O+ to \symb{I} and \symb{U}. + +The \symb{izafet} connection may be written literally, which may look awkward +in the case of \verb+h"'+, or always as \verb+-i+ (with hyphen); then the correct +spelling will be determined from the context. Likewise the \symb{yah-i-wahdat} +can always be written \verb+-I+. + +The final \symb{yah} carries no dots. + +Farsi uses the Nasta`liq font if available. + + +\subsubsection{Ottoman:} + +see Farsi. + + +\subsubsection{Kurdish:} + +see Farsi. + + +\subsubsection{Urdu:} + +The additional characters in Urdu are coded as follows: +% +\begin{codetable}{1} + h & always denotes the ``two-eyed \symb{hah}'' \\ + ,h & the ``wavy'' \symb{hah} letter \\ + ,t & \symb{tah} with a small \symb{ttah} accent \\ + ,d & \symb{dal} with a small \symb{ttah} accent \\ + ,r & \symb{rah} with a small \symb{ttah} accent \\ + .n & \symb{noon} without a dot (modifies a preceding vowel) \\ + E & \symb{yah bari} in the final position, otherwise mapped to \symb{yah} \\ + O & mapped to \symb{U} +\end{codetable} + +The short vowels \verb+e+ and \verb+o+ are mapped to \symb{a} and \symb{u}. + +\emph{Note:} Some of the given codings also occur in Pashto but with a different +meaning, see below. + +Urdu uses the Nasta`liq font if available. + + +\subsubsection{Pashto:} + +The additional characters for Pashto are coded as follows: +% +\begin{codetable}{1} + ,t & \symb{tah} with a small loop \\ + ,d & \symb{dal} with a small loop \\ + ,r & \symb{rah} with a small loop \\ + .n & \symb{noon} with a small loop \\ + g & \symb{gaf} is written with a small loop instead of a bar \\ + ,z & \symb{rah} with one dot above and one below \\ + ,s & \symb{sin} with one dot above and one below \\ + e & like \symb{a}, with a \symb{zwarakay} mark if vocalized \\ + e'i & \symb{yah} with \symb{hamza} \\ + E & \symb{yah} with two dots below aligned vertically \\ + Ey & \symb{yah} written with a final stroke \\ + o & mapped to \symb{u} \\ + O & mapped to \symb{U} \\ + w"' & \symb{hamza} on \symb{waw} \\ + h"' & \symb{hamza} on \symb{hah} +\end{codetable} + +The \symb{qur'an alif} accent is not available for Pashto. + +The rules for \symb{izafet} and \symb{yah-i-wahdat} apply. + +Note: Some of the given codings also occur in Urdu but with a different +meaning, see above. For writing some words in the Urdu style, write the +command \verb+\seturdu+ and afterwards switch back to the Pashto conventions by +\verb+\setpashto+. + + +\subsubsection{Maghribi:} + +This is just a different writing convention. \symb{fah} is written with one dot +below the letter, \symb{qaf} with one dot above the normal letter form of +\symb{fah}. The three dots of \symb{vah} are put below the letter. Otherwise like +Arabic. + + +\subsection{Miscellaneous features:} + +As \ArabTeX is slow, it will produce some terminal output while running +to indicate it is still alive. If that is not wanted, say ``\verb+\quiet+'' or +``\verb*+\tracingarab = 0 +'' (outside an Arabic Environment). ``\verb*+\tracingarab = 1 +'' +will report arabic paragraphs, a value of 2: arabic lines and insertions, +a value of 3 or more: individual items. + +Whether \symb{yah} in the final position carries dots or not depends on the +chosen language convention. You can override this by ``\verb+\yahdots+'' and +``\verb+\yahnodots+''. + +To reproduce erroneous or archaic texts exactly as they are, the +following additional codings are available: +% +\begin{codetable}{1} + .k & \symb{kaf} in final position without a diacritical mark \\ + .f & \symb{fah} without a dot \\ + .b & \symb{bah} without a dot \\ + .n & \symb{noon} without a dot (not available for Pashto) \\ + Y & \symb{alif maqsoura}, \symb{yah} without dots in all positions. \\ +\end{codetable} + + +\subsection{How to move from Version 1 to Version 2} + +Version 2 is not fully compatible with Version 1; however, moving to the +new version should cause little problems, and is recommended as version 1 +is no longer supported. 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 grave bugs 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 can no more be used. +\item Some arabic characters are now coded differently: \symb{`ain} is denoted by a + left quote, and \verb+c+, \verb+^z+, \verb+^t+, and \verb+.n+ denote different characters + from what they did before. This was changed in order to better conform + to the standard transliteration. +\item There are a lot more ligatures than before. This normally need not + concern the user. +\item \verb+\vocalize+ will no more generate \symb{sukun} and \symb{wasla} except if explicitly + indicated by quoting. See \verb+\fullvocalize+. +\item Arabic Environments are always bracketed by the new control sequences\\ + \verb+\begin{arabtext}+ and \verb+\end{arabtext}+ even if only the transcription is + wanted. +\item Short arabic quotations are now bracketed by \verb+\<+ and \verb+>+ so \verb+<+ has its + standard \TeX\ meaning. +\end{itemize} + +We recommend converting existent input files to the new notation. If that +is impractical in special cases, the \LaTeX\ option ``\texttt{oldarabtex}'' and/or the +command ``\verb+\oldarabtex+'' will switch back to most of the old conventions (and +problems). This shortcut will probably go away in some future version. + + +\subsection{Acknowledgments:} + +The development of \ArabTeX would not have been possible without the +assistance of many people. Apart from my local team, helpful advice came +among others from Wolfdietrich Fischer, Ahmed El-Hadi, Abdelsalam Heddaya, +Iqbal Khan, Tom Koornwinder, Eberhard Krueger, Asif Lakehsar, Jan Lodder, +Richard Lorch, Eberhard Mattes, and Bernd Raichle. I also have to thank +the many people who sent bug reports and comments. + + +\subsection{Please send bug reports, suggestions and inquiries to the author:} + +\noindent +Prof. Klaus Lagally\\ +Institut fuer Informatik\\ +Universitaet Stuttgart\\ +Breitwiesenstrasse 20--22\\ +D-70565 Stuttgart \\ +GERMANY + +\medskip +\noindent +\texttt{lagally@informatik.uni-stuttgart.de} + +\bigskip +\noindent +\textbf{Copyright \textcopyright\ 1990--1993, Klaus Lagally} + + +\end{document} diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds index 0ff4af07e05..5e08363f3c8 100755 --- a/Master/tlpkg/libexec/ctan2tds +++ b/Master/tlpkg/libexec/ctan2tds @@ -2441,7 +2441,8 @@ sub MAKEarabi { &SYSTEM ("$CP -r * $DEST/"); } -sub MAKEarabtex { +sub MAKEarabtex +{ &xchdir ($packagedir); # print "\t SPECIAL $package: removing top-level links\n"; @@ -2450,6 +2451,9 @@ sub MAKEarabtex { print "\t SPECIAL $package: removing top-level tgz's\n"; &SYSTEM('for f in *.tgz; do rm -v $f; done'); # + print "\t SPECIAL $package: removing bitmap fonts\n"; + &SYSTEM("rm -rf laser.pk"); + # print "\t SPECIAL $package: renaming arabtex.htm\n"; &SYSTEM('mv doc/html/arabtex.htm arabtex1.htm'); &SYSTEM('mv doc/txt/arabtex.htm arabtex2.htm'); @@ -2457,6 +2461,9 @@ sub MAKEarabtex { print "\t SPECIAL $package: flatten\n"; &xchdir (".."); &MAKEflatten (); + # + print "\t SPECIAL $package: removing redundant files\n"; + &SYSTEM("rm -rf doc texinput"); } sub MAKEarphic { |