home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1998 #4 / amigaacscoverdisc1998-041998.iso / utilities / shareware / dtp / amiweb2c-2.1 / amiweb2c.txt < prev    next >
Encoding:
Text File  |  1998-03-15  |  10.9 KB  |  307 lines
  1.  
  2.  
  3.              LaTeX installation instructions for AmiWeb2c TeX
  4.  
  5.                                15 March 1998
  6.  
  7.  
  8. SUMMARY
  9. =======
  10.  
  11. This file contains instructions on how to install LaTeX for Web2c TeX
  12. on the Amiga (aka AmiWeb2c).  Before reading this file, you should read
  13. install.txt, which will explain how the LaTeX installation works, and
  14. web2c.txt, which describes the Unix version of this TeX system.
  15.  
  16. This file describes:
  17.  
  18.  * How to save any old version of LaTeX.
  19.  
  20.  * How to configure LaTeX.
  21.  
  22.  * How to unpack the LaTeX distribution.
  23.  
  24.  * How to install the LaTeX files.
  25.  
  26.  * How to create the LaTeX format.
  27.  
  28.  * What to do if you have any problems.
  29.  
  30.  
  31. REQUIREMENTS
  32. ============
  33.  
  34. In addition to the LaTeX distribution files, you will also need the
  35. following:
  36.  
  37.  * the file `/texmf/tex/generic/local/hyphen.cfg' coming with the source
  38.    distribution of AmiWeb2c, loading hyphenation patterns for US English
  39.    (hyphen.tex aka ushyph1.tex) and UK English (ukhyphen.tex), and German
  40.    (ghyph31.tex).  In the commentary section of `hyphen.cfg' a list of
  41.    many other languages is given together with references to pattern
  42.    files.  Feel free to modify `hyphen.cfg' as you need (or replace it
  43.    with your own version).
  44.  
  45.  
  46. SAVING ANY OLD VERSION OF LATEX
  47. ===============================
  48.  
  49. Nobody should ever have installed LaTeX 2.09 with AmiWeb2c (which was
  50. first released in April/May 1995), so there is no need for a special
  51. treatment of such an old version of LaTeX.
  52.  
  53. Updating installations of LaTeX2e is completely similar to a generic
  54. LaTeX installation.  This simply amounts to replacing all files with
  55. their new versions and recreating the LaTeX format file `latex.fmt'.
  56.  
  57.  
  58. CONFIGURING LATEX
  59. =================
  60.  
  61. During the installation procedure, it may be easiest to set some
  62. temporary device names.
  63.  
  64. The LATEXINPUTS: directory is where the LaTeX base packages and classes
  65. will finally be installed.  In the `TeX Directory Structure' assumed by
  66. AmiWeb2c this defaults to:
  67.  
  68.    assign LATEXINPUTS: HD:AmiWeb2c-<version>/texmf/tex/latex/base
  69.  
  70. The LATEXFORMAT: directory is where the LaTeX format is stored:
  71.  
  72.    assign LATEXFORMAT: HD:AmiWeb2c-<version>/texmf/web2c
  73.  
  74. The LATEXDIST: directory is where the LaTeX distribution is stored:
  75.  
  76.    assign LATEXDIST: HD:AmiWeb2c-<version>/texmf/source/latex/base
  77.  
  78. You should put all files coming with the base distribution of LaTeX in
  79. the LATEXDIST: directory.  After the successful installation procedure,
  80. you can safely remove the complete LATEXDIST: directory.
  81.  
  82. If you started with the ready-to-use binaries, I suggest that you get
  83. Norbert Püschel's `DOSPrefs' commodity from the Aminet at
  84.  
  85.    Aminet:/util/misc/DOSPrefs31.lha
  86.  
  87. This program patches the AmigaOS to enable the Unix notations `.' and
  88. `..' for the `current' and the `parent' directory respectively.  There
  89. are similar tools for this purpose, but AmiWeb2c was only tested with
  90. `DOSPrefs'.  For your convenience, "DOSPrefs 3.1" is included with the
  91. AmiWeb2c distribution.
  92.  
  93.  
  94. UNPACKING THE DISTRIBUTION
  95. ==========================
  96.  
  97. To unpack the LaTeX distribution, you should:
  98.  
  99.    cd LATEXDIST:
  100.    tex --ini unpack.ins
  101.  
  102. This takes about 15 minutes on a 50 MHz 68030, but considerably longer
  103. on a standard 7.19 MHz 68000 (most likely several hours).  Why don't you
  104. just go and make a good cup of tea?  [Personal note:  on a P5/133 running
  105. the Linux operating system the very same task takes about half a minute,
  106. so I have my tea ready before I install a new version of LaTeX.]
  107.  
  108.  
  109. PUTTING THE FILES WHERE LATEX CAN READ THEM
  110. ===========================================
  111.  
  112. How was your tea?  To install the LaTeX files created in the previous
  113. step, you should:
  114.  
  115.    cd LATEXDIST:
  116.    copy latexbug.tex testpage.tex lablst.tex idx.tex ltxcheck.tex +
  117.       nfssfont.tex small2e.tex sample2e.tex docstrip.tex +
  118.       #?.cls #?.clo #?.sty #?.fd #?.def #?.ltx +
  119.    LATEXINPUTS:
  120.  
  121. (The `+' character means that you should type this as a single command.)
  122.  
  123. WARNING:  This single command line most certainly exceeds the maximum
  124. length the AmigaOS is able to cope with!  Please, make sure that ALL
  125. these files are correctly installed in `LATEXINPUTS:'.  And make sure
  126. that all these files are copied "as is", the file lookup mechanism of
  127. AmiWeb2c won't find files with incorrect uppercase/lowercase spelling,
  128. e.g., OT1enc.def (old) versus ot1enc.def (new).
  129.  
  130. If you have MakeIndex installed or intend to do so, copy #?.ist to the
  131. MakeIndex inputs directory, which should be in TDS notation:
  132.  
  133.    /texmf/makeindex/
  134.  
  135.  
  136. CREATING THE LATEX FORMAT
  137. =========================
  138.  
  139. After the unpacked files of the LaTeX distribution are installed at
  140. the appropriate place, you have to create the LaTeX format proper.
  141. This will conveniently be done by the following commands:
  142.  
  143.    cd LATEXFORMAT:
  144.    tex --ini --progname=latex latex.ltx
  145.  
  146. Thus the format file latex.fmt will be created at the correct place and
  147. also the correctness of the installation will be tested, because the
  148. necessary files will be read from the appropriate paths.  A useful
  149. shortcut to invoke LaTeX is `alias latex="tex --progname=latex"'.
  150.  
  151. If you intend to use any of the advanced features provided by `e-TeX'
  152. (`enhanced TeX'), like left-to-right typesetting, you should instead
  153. use the commands
  154.  
  155.    cd LATEXFORMAT:
  156.    etex --ini --efmt=elatex *latex.ltx
  157.    etex --ini --progname=elatex latex.ltx
  158.  
  159. to create the format file and set `alias elatex="etex --progname=elatex"'
  160. and `alias latex="etex --progname=latex"'.  (Note the asterisk in front of
  161. `latex.ltx'; this invokes a special feature of the etex binary, i.e., the
  162. `extended mode of e-TeX'.)
  163.  
  164. If you intend to produce output in Portable Document Format (PDF) from
  165. your LaTeX sources, you may additionally use the command
  166.  
  167.    cd LATEXFORMAT:
  168.    pdftex --ini --progname=pdflatex latex.ltx
  169.  
  170. together with `alias pdflatex="pdftex --progname=pdflatex"'.
  171.  
  172. If you intend to use the 16-bit UniCode version of TeX, aka Omega, you
  173. may additionally use the command
  174.  
  175.    cd LATEXFORMAT:
  176.    omega --ini --progname=lambda lambda.tex
  177.  
  178. together with `alias lambda="omega --progname=lambda"'.
  179.  
  180.  
  181. GETTING A WORKING LaTeX
  182. =======================
  183.  
  184. As soon as the format file `latex.fmt' is created in the proper place, you
  185. are set for using LaTeX.  Either use `alias latex "tex --progname=latex"'
  186. or `makelink from latex to tex' to conveniently set up a `latex' call.
  187.  
  188. Oh, and don't forget to remake the ls-R database!
  189.  
  190.  
  191. CHECKING THAT THE INSTALLATION WORKED
  192. =====================================
  193.  
  194. To check that the installation worked, you should:
  195.  
  196.    cd LATEXFORMAT:
  197.    latex ltxcheck
  198.  
  199. This will perform a number of tests, which should all report `OK',
  200. except for the "\@currdir" part (and, depending on your installation,
  201. the "DC/EC" font stuff).  According to the LaTeX check routine, all
  202. files come from the current working directory, contrary to the common
  203. installation.  Due to the limitations of the Amiga implementation of
  204. file lookup, which is inherently very Unix-prone, there seems to be
  205. no remedy to this situation.  Press "return" to skip the warnings.
  206.  
  207.  
  208. PROBLEMS
  209. ========
  210.  
  211. `texsys.cfg':  Due to technical limitations of the Amiga port of the
  212.    Kpathsea library it is necessary to "\let\@currdir=\@empty" in this
  213.    file.  The LaTeX test suite "latex ltxcheck" will issue a warning
  214.    message when checking the current directory syntax.  Proceed.
  215.  
  216. `File missing':  As long as the default search paths of AmiWeb2c are
  217.    correctly set up and used, you won't encounter this message.
  218.  
  219. `Font missing':  Some of the fonts, i.e., tfm files, required by LaTeX
  220.    are missing.  In addition to the 75 standard fonts of the `Computer
  221.    Modern' family, several additional fonts are needed.  Run MetaFont
  222.    on the respective font drivers and install the tfm files in the
  223.    `texmf/fonts/tfm//' directory structure.  You may choose to ignore
  224.    the warning about the missing `EC' fonts issued by the LaTeX
  225.    check suite.
  226.  
  227. `Out of memory':  The memory configuration file `texmf.cnf' coming with
  228.    the source distribution of AmiWeb2c in `texmf/web2c/' was used for the
  229.    installation of LaTeX on my system, so it should be appropriate for
  230.    your machine too.  Since AmiWeb2c is directly descended from the Unix
  231.    Web2c distribution, its binaries are designed for a BigTeX setup.  If
  232.    you really want to install it on machines with less than 4 MB of RAM,
  233.    you will most likely have to restrict yourself to a single language in
  234.    `texmf/tex/generic/local/hyphen.cfg' and comment the value for `triesize'
  235.    in `texmf/web2c/texmf.cnf' in order to start IniTeX.  Please do not
  236.    request a SmallTeX version of AmiWeb2c, it just can't be done.
  237.  
  238. If you have any other problems with the LaTeX installation, see the
  239. `PROBLEMS' section in install.txt.
  240.  
  241.  
  242. CLEARING UP
  243. ===========
  244.  
  245. You may now be wondering what to do with all the remaining files that
  246. are not needed to run LaTeX.  This is, of course, a matter of personal
  247. taste and availability of disk space but here is some guidance.
  248.  
  249.  * The files with extension .dtx, together with source2e.tex, can be
  250.    used to typeset the documented source code (see texpert.txt for
  251.    further information).
  252.  
  253.  * The files with extension .fdd contain the documented sources for the
  254.    font definition files.
  255.  
  256.  * The files ltnews<xx>.tex and ltnews<xx>.ps both contain the lastest
  257.    LaTeX newsletter.
  258.  
  259.  * The file ltx3info.tex contains information about the LaTeX3 project
  260.    and how you can support it.
  261.  
  262.  * The files with extension .txt contain information about (amongst
  263.    other things) copyright, installation, patches and bug-reports;
  264.    and those with extension .err contain errata lists for various
  265.    publications: see 00readme.txt for further details.
  266.  
  267.  * The files with names of the form <xxx>guide.tex contain reference
  268.    information convering only those features new to this version of
  269.    LaTeX: they are not intended to be either a user guide or a
  270.    complete reference.
  271.  
  272.  * The files with extension .ltx, together with latexcheck.tex, are
  273.    used to create and test the format; therefore you should keep these
  274.    together with the installed LaTeX system in the LATEXINPUTS:
  275.    directory if you expect to remake the format before getting the next
  276.    full distribution.
  277.  
  278.  * The files with extension .ins are used to unpack the code from the
  279.    .dtx and .fdd files.
  280.  
  281.  * We recommend that you keep, in the LATEXFORMAT: directory, the
  282.    transcript file latex.log that was produced whilst creating the
  283.    format.
  284.  
  285. If you don't need the documentation or if you are lacking enough disk
  286. space to permanently keep the LaTeX distribution files, you can now:
  287.  
  288.    delete LATEXDIST:#?
  289.  
  290.  
  291. SYSTEM-SPECIFIC SECTIONS
  292. ========================
  293.  
  294. As the maintainer and distributor of AmiWeb2c I'm interested in feedback
  295. about problems with the application of this TeX system for the Amiga.
  296. Please report difficulties installing and/or using LaTeX that are
  297. clearly related to any (mis)feature of AmiWeb2c to
  298.  
  299.    Andreas Scherer
  300.    Rochusstraße 22-24
  301.    52062 Aachen, Germany
  302.    <andreas.scherer@pobox.com>
  303.  
  304.  
  305.    --- Copyright 1995, 1998 Andreas Scherer and the LaTeX3 project. ---
  306.    ---                    All rights reserved.                      ---
  307.