diff options
Diffstat (limited to 'language/arabic/arabtex/doc/txt/readme.305')
-rw-r--r-- | language/arabic/arabtex/doc/txt/readme.305 | 310 |
1 files changed, 155 insertions, 155 deletions
diff --git a/language/arabic/arabtex/doc/txt/readme.305 b/language/arabic/arabtex/doc/txt/readme.305 index 79edc535ef..b5fb8a6d01 100644 --- a/language/arabic/arabtex/doc/txt/readme.305 +++ b/language/arabic/arabtex/doc/txt/readme.305 @@ -1,155 +1,155 @@ -README.305 15.03.1997
---------------------------------------------------------------------------
- ArabTeX Version 3.05
- ====================
---------------------------------------------------------------------------
- Additional features not described in the User Manual
-
-| For changes after version 3.02 see change bars in the margin
---------------------------------------------------------------------------
-
- 1. Bidirectional linebreaking
- -----------------------------
- Within a Roman paragraph, Arabic insertions may be included
- by the construct \<Arabic text> ( <Arabic text> initially does
- the same but may be redefined by the user for other purposes).
- This construct, though efficient, has the inherent limitation
- that the contents must fit on the current line, or else the
- user has to break the text by \| or \break at some reasonable
- place. Likewise, within an Arabic paragraph Roman insertions
- may be included by <Roman text>, with the same limitations.
-
- In many cases, as e.g. in the User Manual, insertions are very
- short by nature, so the limitations pose no problem. For other
- applications where the included quotations are much longer than
- part of a line, some additional commands are provided. These are
-| much less efficient and also have a high demand on storage, so
-| they should only be used when necessary.
-
- - \RL {Arabic text} allows an insertion of arbitrary length; the
- lines will be broken automatically. Due to some limitations that
- are inherent in TeX's algorithm, the line containing the start of
- the insertion may come out underfull, and also its baseline may be
- broken. Whenever this happens (only in main vertical mode, never
- within footnotes, parboxes, or minipages), use of the command
- \goodpar {paragraphs} may help (see below.)
-
- - \LR {Roman text} does the same for long Roman insertions in an
- Arabic paragraph. Here there is no problem with the baseline.
-
- - \goodpar {Roman paragraphs} will fix the problems with \RL for
- insertions within the included paragraphs, but might lead to main
- memory overflow; so use it with care, or use Big TeX.
-
- - \mbox {\RL {Arabic text}} is equivalent to \<Arabic text>: no
- line-breaking, as usual.
-
- - \RL in Arabic mode, and \LR in Roman mode, do no harm but are
- redundant.
-
- - the user may, at her/his own risk, include \LR portions within
- \RL portions, and vice versa. This may lead to some interesting
- effects (for details, see: Donald E. Knuth and Pierre MacKay,
- Mixing right-to-left texts with left-to-right texts, TUGboat,
- Volume 8(1987), No. 1, p. 14 - 25)
-
---------------------------------------------------------------------------
-
- 2. Processing Hebrew with ArabTeX
- ---------------------------------
- An experimental extension that (partially) supports Hebrew may
- be installed by the LaTeX option "hebtex", or \input hebtex.sty.
-| It provides an additional language mode \sethebrew, and several
-| common encodings of texts in Hebrew, that may be switched by
-| the \setcode command. One of the encodings is compatible with
-| Dov Grobgeld's editor HED, so files prepared for HebrewTeX are
-|| supposed to be compatible, including most HebrewTeX commands
-|| (the Hebrew date quite probably does NOT work correctly).
-|| Hebrew "newcode" encoding (ISO 8859-8) probably works too, but
- has not yet been tested extensively. In addition, the standard
- ArabTeX transliteration encoding is also available.
-
-|| For more information, see the text file "hebrew.305". Please
-|| observe that the encoding of vowels written "plene" has been
-|| changed (due to user suggestions!)
-
---------------------------------------------------------------------------
-
- 3. Support for Arabic Windows
- -----------------------------
- Isam G. Ishaq programmed, and donated, a new reading module for
-| the Arabic encoding CP 1256 supported by Arabic Windows. It is
- installed as a LaTeX option "arabwin" and may be activated by
-| \setcode {arabwin} or \setcode {cp1256}.
- Some documentation is contained in the file "arwindoc.tex"; try
- to process it with ArabTeX, or just read the ASCII text.
-
- As we had little opportunity to test it, this module is supplied
- as is, without any warranty (as usual), nor support.
-
---------------------------------------------------------------------------
-
- 4. Support for EDMAC
- --------------------
- In the transition from EDMAC 3.00 to EDMAC 3.15, some internal
-|| interfaces have changed. ArabTeX 3.05 will adjust itself to the
- version used automatically.
-
- The EDMAC commands \pstart, \pend, and \autopar can now also be
- used within an Arabic paragraph.
-
---------------------------------------------------------------------------
-
-| 5. Module Reporting
-| -------------------
-| A complete list of the modules loaded in a particular run will
-| be put into the log file (before the run statistics), if LaTeX
-| is used. This is believed to be useful when tracing down errors.
-| This list is also available to the user, even with Plain TeX,
-| as the contents of the new control sequence \arabtexconfig.
-| This feature may disappear again.
-
---------------------------------------------------------------------------
-
-| 6. Running ArabTeX with LaTeX2e
-| -------------------------------
-| Up to now we experienced no problems; the only changes we found
-| necessary are loading ArabTeX and its suboptions not as class
-| options but by using the command \usepackage.
-
---------------------------------------------------------------------------
-|| 7. Arabic document classes
-|| --------------------------
-|| The experimental LaTeX2e classes "arabart", "arabbook", "arabrep"
-|| extend the standard classes "article", "book", and "report" in
-|| two respects:
-||
-|| - The overall document layout has been "arabized": page numbers
-|| are in Indic numerals, and columns run from right to left.
-||
-|| - Within Arabic environments bracketed by \begin{arabtext} and
-|| \end{arabtext} most LaTeX commands are allowed, including all
-|| sectioning commands, \tabular, \tabbing, even \tableofcontents,
-|| and use an "Arabic looking" format. All arguments that denote
-|| text to be typeset are interpreted according to the currently
-|| activated Arabic encoding. Other arguments keep their standard
-|| meaning, including the preamble of \tabular, whose columns are
-|| processed from left to right (visual formatting).
-||
-|| - Outside of Arabic environments the LaTeX commands revert to the
-|| standard meaning.
-||
-|| The new classes are still in "alpha" status; reports are welcome.
-
---------------------------------------------------------------------------
- Prof. Klaus Lagally
- Institut fuer Informatik
- Universitaet Stuttgart
- Breitwiesenstrasse 20-22
- D-70565 Stuttgart
- GERMANY
-
- lagally@informatik.uni-stuttgart.de
---------------------------------------------------------------------------
-| Copyright (c) 1990 - 1997, Klaus Lagally
---------------------------------------------------------------------------
+README.305 15.03.1997 +-------------------------------------------------------------------------- + ArabTeX Version 3.05 + ==================== +-------------------------------------------------------------------------- + Additional features not described in the User Manual + +| For changes after version 3.02 see change bars in the margin +-------------------------------------------------------------------------- + + 1. Bidirectional linebreaking + ----------------------------- + Within a Roman paragraph, Arabic insertions may be included + by the construct \<Arabic text> ( <Arabic text> initially does + the same but may be redefined by the user for other purposes). + This construct, though efficient, has the inherent limitation + that the contents must fit on the current line, or else the + user has to break the text by \| or \break at some reasonable + place. Likewise, within an Arabic paragraph Roman insertions + may be included by <Roman text>, with the same limitations. + + In many cases, as e.g. in the User Manual, insertions are very + short by nature, so the limitations pose no problem. For other + applications where the included quotations are much longer than + part of a line, some additional commands are provided. These are +| much less efficient and also have a high demand on storage, so +| they should only be used when necessary. + + - \RL {Arabic text} allows an insertion of arbitrary length; the + lines will be broken automatically. Due to some limitations that + are inherent in TeX's algorithm, the line containing the start of + the insertion may come out underfull, and also its baseline may be + broken. Whenever this happens (only in main vertical mode, never + within footnotes, parboxes, or minipages), use of the command + \goodpar {paragraphs} may help (see below.) + + - \LR {Roman text} does the same for long Roman insertions in an + Arabic paragraph. Here there is no problem with the baseline. + + - \goodpar {Roman paragraphs} will fix the problems with \RL for + insertions within the included paragraphs, but might lead to main + memory overflow; so use it with care, or use Big TeX. + + - \mbox {\RL {Arabic text}} is equivalent to \<Arabic text>: no + line-breaking, as usual. + + - \RL in Arabic mode, and \LR in Roman mode, do no harm but are + redundant. + + - the user may, at her/his own risk, include \LR portions within + \RL portions, and vice versa. This may lead to some interesting + effects (for details, see: Donald E. Knuth and Pierre MacKay, + Mixing right-to-left texts with left-to-right texts, TUGboat, + Volume 8(1987), No. 1, p. 14 - 25) + +-------------------------------------------------------------------------- + + 2. Processing Hebrew with ArabTeX + --------------------------------- + An experimental extension that (partially) supports Hebrew may + be installed by the LaTeX option "hebtex", or \input hebtex.sty. +| It provides an additional language mode \sethebrew, and several +| common encodings of texts in Hebrew, that may be switched by +| the \setcode command. One of the encodings is compatible with +| Dov Grobgeld's editor HED, so files prepared for HebrewTeX are +|| supposed to be compatible, including most HebrewTeX commands +|| (the Hebrew date quite probably does NOT work correctly). +|| Hebrew "newcode" encoding (ISO 8859-8) probably works too, but + has not yet been tested extensively. In addition, the standard + ArabTeX transliteration encoding is also available. + +|| For more information, see the text file "hebrew.305". Please +|| observe that the encoding of vowels written "plene" has been +|| changed (due to user suggestions!) + +-------------------------------------------------------------------------- + + 3. Support for Arabic Windows + ----------------------------- + Isam G. Ishaq programmed, and donated, a new reading module for +| the Arabic encoding CP 1256 supported by Arabic Windows. It is + installed as a LaTeX option "arabwin" and may be activated by +| \setcode {arabwin} or \setcode {cp1256}. + Some documentation is contained in the file "arwindoc.tex"; try + to process it with ArabTeX, or just read the ASCII text. + + As we had little opportunity to test it, this module is supplied + as is, without any warranty (as usual), nor support. + +-------------------------------------------------------------------------- + + 4. Support for EDMAC + -------------------- + In the transition from EDMAC 3.00 to EDMAC 3.15, some internal +|| interfaces have changed. ArabTeX 3.05 will adjust itself to the + version used automatically. + + The EDMAC commands \pstart, \pend, and \autopar can now also be + used within an Arabic paragraph. + +-------------------------------------------------------------------------- + +| 5. Module Reporting +| ------------------- +| A complete list of the modules loaded in a particular run will +| be put into the log file (before the run statistics), if LaTeX +| is used. This is believed to be useful when tracing down errors. +| This list is also available to the user, even with Plain TeX, +| as the contents of the new control sequence \arabtexconfig. +| This feature may disappear again. + +-------------------------------------------------------------------------- + +| 6. Running ArabTeX with LaTeX2e +| ------------------------------- +| Up to now we experienced no problems; the only changes we found +| necessary are loading ArabTeX and its suboptions not as class +| options but by using the command \usepackage. + +-------------------------------------------------------------------------- +|| 7. Arabic document classes +|| -------------------------- +|| The experimental LaTeX2e classes "arabart", "arabbook", "arabrep" +|| extend the standard classes "article", "book", and "report" in +|| two respects: +|| +|| - The overall document layout has been "arabized": page numbers +|| are in Indic numerals, and columns run from right to left. +|| +|| - Within Arabic environments bracketed by \begin{arabtext} and +|| \end{arabtext} most LaTeX commands are allowed, including all +|| sectioning commands, \tabular, \tabbing, even \tableofcontents, +|| and use an "Arabic looking" format. All arguments that denote +|| text to be typeset are interpreted according to the currently +|| activated Arabic encoding. Other arguments keep their standard +|| meaning, including the preamble of \tabular, whose columns are +|| processed from left to right (visual formatting). +|| +|| - Outside of Arabic environments the LaTeX commands revert to the +|| standard meaning. +|| +|| The new classes are still in "alpha" status; reports are welcome. + +-------------------------------------------------------------------------- + Prof. Klaus Lagally + Institut fuer Informatik + Universitaet Stuttgart + Breitwiesenstrasse 20-22 + D-70565 Stuttgart + GERMANY + + lagally@informatik.uni-stuttgart.de +-------------------------------------------------------------------------- +| Copyright (c) 1990 - 1997, Klaus Lagally +-------------------------------------------------------------------------- |