home *** CD-ROM | disk | FTP | other *** search
/ Dream 46 / Amiga_Dream_46.iso / os2 / Latex / install.eng < prev    next >
Text File  |  1997-11-13  |  29KB  |  776 lines
  1. ==============================================================================
  2. INSTALL.ENG (emTeX DISTRIBUTION)                                   19-Sep-1995
  3. ==============================================================================
  4.  
  5.                              Installing emTeX
  6.  
  7. ------------------------------------------------------------------------------
  8. Contents
  9. ------------------------------------------------------------------------------
  10.  
  11. - Introduction
  12. - What to do if an old version of emTeX is already installed
  13. - Installing Info-ZIP's UnZip
  14. - Installing a package
  15. - Updating a package
  16. - Installing emTeX
  17.   1. First things first
  18.   2. Adding support for 32-bit programs
  19.   3. Installing the TeX compiler
  20.   4. Installing METAFONT
  21.   5. Installing the printer drivers, screen previewers, and fonts
  22.   6. Installing MakeIndex
  23.   7. Installing BibTeX
  24.   8. Installing TeXcad
  25.   9. Installing dvispell
  26.   10. Installing PiCTeX
  27.   11. Installing WEB
  28.   12. Viewing and printing additional documentation
  29. - Installing emTeX in a different directory
  30. - Removing a package
  31. - Unpacking LaTeX2e
  32. - Sample autoexec.bat for DOS
  33. - Sample config.sys for OS/2
  34.  
  35.  
  36. ------------------------------------------------------------------------------
  37. Introduction
  38. ------------------------------------------------------------------------------
  39.  
  40. IMPORTANT: See HELP.ENG if you encounter any problems.  That file is
  41. available separately and in first.zip, as \emtex\doc\english\help.eng.
  42.  
  43. Simplified installation instructions are available in QUICK.ENG.  See
  44. the introduction of QUICK.ENG to see whether you can use and want to
  45. use those instructions.
  46.  
  47. These installation instructions assume that emTeX will be installed on
  48. drive C: in directory \emtex and that the distribution files are on
  49. diskettes in drive A:. If you choose to install emTeX in a different
  50. directory or if the distribution files are in a different location,
  51. you have to modify the commands appropriately.
  52.  
  53.  
  54. ------------------------------------------------------------------------------
  55. What to do if an old version of emTeX is already installed
  56. ------------------------------------------------------------------------------
  57.  
  58. This emTeX distribution completely replaces any previously distributed
  59. emTeX versions. If you already have emTeX installed, you must entirely
  60. remove (or rename) the installed \emtex directory tree. Moreover, you
  61. should un-set all environment variables you had defined for previous
  62. emTeX versions: delete all SET commands for the following environment
  63. variables from autoexec.bat and config.sys:
  64.  
  65.     BIBINPUT    BTEXFMT     MFBAS       MFJOB       TEXINPUT
  66.     BMFBAS      EMTEXDRV    MFINPUT     TEXFMT      TEXTFM
  67.  
  68. Moreover, remove the \emtex directory from PATH (this release of emTeX
  69. uses \emtex\bin instead of \emtex).  After modifying autoexec.bat or
  70. config.sys, you should reboot your machine.  Do this now to avoid
  71. installation problems caused by the old settings of the environment
  72. variables.
  73.  
  74. (The environment variables listed above still exist, with the
  75. exception of EMTEXDRV which has been replaced by EMTEXDIR.  However,
  76. the old settings disable subdirectory search, prohibiting proper
  77. operation of emTeX.  Moreover, setting EMTEXDIR is sufficient in most
  78. cases.)
  79.  
  80. If you have installed third-party packages such as dvips, it is
  81. recommended to remove all emTeX packages with the `emremove' tool and
  82. then rename the \emtex directory:
  83.  
  84.     emremove c:\emtex\remove\tex.rem c:\
  85.     emremove c:\emtex\remove\mf.rem c:\
  86.     etc. etc. etc.
  87.     move c:\emtex emtex.old
  88.  
  89. You can find emremove.exe in first.zip.
  90.  
  91. To delete the entire emTeX directory tree, type
  92.  
  93.     cd \
  94.     emdelete -r c:\emtex
  95.  
  96. using emdelete.exe from first.zip (previous versions of delete.exe
  97. require a different syntax).  To get the new emdelete.exe, follow the
  98. instructions for unpacking first.zip below, then copy emdelete.exe to
  99. a directory listed in PATH.
  100.  
  101. Note that you should copy emdelete.exe to another directory if it is
  102. currently located in the directory tree to be deleted.
  103.  
  104. Since by this procedure all files in the directory c:\emtex and in all
  105. subdirectories of this directory will be deleted, you should not use
  106. this directory for your own files!
  107.  
  108.  
  109. ------------------------------------------------------------------------------
  110. Installing Info-ZIP's UnZip
  111. ------------------------------------------------------------------------------
  112.  
  113. emTeX is packaged using Info-ZIP's compression utility.  Info-ZIP's
  114. software (Zip, UnZip and related utilities) is free and can be
  115. obtained as source code or executables from various bulletin board
  116. services and anonymous-ftp sites, including CompuServe's IBMPRO forum
  117. and ftp.uu.net:/pub/archiving/zip/*.
  118.  
  119. Prior to installing emTeX, you have to install UnZip (unless UnZip is
  120. already installed).  UnZip is distributed as self-extracting archive,
  121. that is, an .exe file with a ZIP archive attached which will be
  122. unpacked when running the .exe file.  The UnZip files should be put
  123. into a scratch directory.  The following examples assume that the
  124. UnZip self-extracting archives are stored on a diskette in drive A:.
  125.  
  126. If you are using OS/2, type
  127.  
  128.     md \unzip
  129.     cd \unzip
  130.     a:\unz512
  131.  
  132. to unpack UnZip into directory \unzip.
  133.  
  134. If you are using DOS, type
  135.  
  136.     md \unzip
  137.     cd \unzip
  138.     a:\unz512x3
  139.  
  140. to unpack UnZip into directory \unzip.
  141.  
  142. After unpacking UnZip, you'll find several documentation and
  143. executable files.
  144.  
  145. For installing emTeX, you have to choose an UnZip executable and put
  146. it into a directory of the PATH under the name `unzip.exe'.
  147.  
  148. For OS/2, the following two UnZip executables are available:
  149.  
  150.     unzip16.exe         16-bit executable for OS/2 1.0 and later
  151.     unzip32.exe         32-bit executable for OS/2 2.0 and later
  152.  
  153. For DOS, the following two UnZip executables are available:
  154.  
  155.     unzip.exe           16-bit executable for 8088 and better CPUs
  156.     unzip386.exe        32-bit executable for 80386 and better CPUs
  157.  
  158. If your machine is equipped with a 80386 CPU or better, you can use a
  159. 32-bit executable.  The 32-bit executables are usually faster than
  160. their 16-bit counterparts, there are no other differences.  If the
  161. 32-bit executable does not work for you, try the 16-bit executable.
  162.  
  163. For instance, to use unzip386.exe type
  164.  
  165.     copy unzip386.exe c:\bin\unzip.exe
  166.  
  167. if c:\bin is a directory listed in your PATH.  The rest of this
  168. document assumes that UnZip is invoked by typing `unzip'.
  169.  
  170. See unzip.doc for further information on UnZip.
  171.  
  172.  
  173. ------------------------------------------------------------------------------
  174. Installing a package
  175. ------------------------------------------------------------------------------
  176.  
  177. Before installing an update of a package, you should remove the
  178. previously installed version of that package.  See below.
  179.  
  180. Installing a package involves unpacking the ZIP archive files of that
  181. package.  Most packages are distributed in one ZIP archive file.
  182.  
  183. To unpack a ZIP archive file select as current working directory the
  184. directory into which the `emtex' directory should be placed.
  185. Typically this is the root directory of your C: drive:
  186.  
  187.     c:
  188.     cd \
  189.  
  190. To unpack, say, first.zip from drive A:, type the following command:
  191.  
  192.     unzip a:\first
  193.  
  194. Directories will be created as required.
  195.  
  196. To view the contents (file listing) of the ZIP archive file, type
  197.  
  198.     unzip -l a:\first
  199.  
  200. To update a package (that is, install a newer version of a package
  201. that is already installed), remove the currently installed package
  202. with emremove.exe (see below), then install the new package.
  203.  
  204. Before updating a package, you might want to check whether the new ZIP
  205. archive files are readable and not corrupted.  This can be done by
  206. running
  207.  
  208.     unzip -tq a:\*.zip
  209.  
  210.  
  211. ------------------------------------------------------------------------------
  212. Updating a package
  213. ------------------------------------------------------------------------------
  214.  
  215. Before installing an update of a package, you should remove the
  216. previously installed version of that package.  See below.
  217.  
  218.  
  219. ------------------------------------------------------------------------------
  220. Installing emTeX
  221. ------------------------------------------------------------------------------
  222.  
  223. 1. First things first
  224. ---------------------
  225.  
  226. Please remove all environment variables of any previously installed
  227. emTeX version (EMTEXDRV, MFINPUT, TEXINPUT, TEXTFM, etc.) from
  228. config.sys and/or autoexec.bat.
  229.  
  230. First, you should install package `first' which contains documentation
  231. files and some tools.  As explained above, this is done approximately
  232. this way:
  233.  
  234.     c:
  235.     cd \
  236.     unzip a:\first
  237.  
  238. As usual, the drive letters and directories depend on where you choose
  239. to install emTeX and where the ZIP files are located.
  240.  
  241. After unpacking first.zip, you should add the directory c:\emtex\bin
  242. to your PATH.  PATH is either set in config.sys or in autoexec.bat.
  243.  
  244. You should also set the EMTEXDIR environment variable to point to the
  245. emTeX directory:
  246.  
  247.     set emtexdir=c:\emtex
  248.  
  249. Please don't use spaces! (`set emtexdir = c:\emtex' won't work!)
  250.  
  251. DOS users should verify that the config.sys file specifies at least
  252.  
  253.     FILES=20
  254.     BUFFERS=20
  255.  
  256. If these statements are missing or if the values are smaller than
  257. shown above, you should insert these statements or increase the values
  258. to at least the values shown above.
  259.  
  260. OS/2 users might want to add c:\emtex\book\english to the BOOKSHELF
  261. environment variable set in config.sys.  That simplifies viewing the
  262. OS/2 on-line manuals of emTeX.
  263.  
  264. Some programs need a directory for scratch files.  Those temporary
  265. files are stored in the directory pointed to by the TMP environment
  266. variable:
  267.  
  268.     md c:\tmp
  269.     set tmp=c:\tmp
  270.  
  271. You might want to use a RAM disk for scratch files.  For instance, if
  272. your RAM disk has drive letter F, set TMP like this:
  273.  
  274.     set tmp=f:\
  275.  
  276. However, you should not install a RAM disk for emTeX's scratch files
  277. as using RAM directly is more efficient.
  278.  
  279. In the process of installing various emTeX components, several
  280. environment variables have to be set.  You can use the batch files
  281. \emtex\bin\set_tex.bat and \emtex\bin\set_tex.cmd as models.
  282.  
  283. If the computer complains about not enough environment space, you
  284. should consult your DOS manual concerning the SHELL statement of
  285. config.sys and concerning the /E and /P options of COMMAND.COM. In
  286. most versions of DOS, adding a line reading
  287.  
  288.     SHELL=C:\DOS\COMMAND.COM C:\DOS /E:1024 /P
  289.  
  290. to config.sys will work (this example assumes that DOS is installed in
  291. directory c:\dos).  If you already have such a line in config.sys, you
  292. might have to increase the value of the /E option by approximately
  293. 512.
  294.  
  295. After changing config.sys and autoexec.bat, you should reboot to
  296. effect the changes.  However you might want to delay rebooting until
  297. after installing emx.
  298.  
  299.  
  300. 2. Adding support for 32-bit programs
  301. -------------------------------------
  302.  
  303. If you have a 386 CPU or better, you can use special 32-bit versions
  304. of some programs which take advantage of that CPU.  Those 32-bit
  305. versions require installation of package `emxrsx'.  This package is
  306. special as it puts files both into the EMTEX directory (like all the
  307. other packages) and the EMX directory.  emxrsx.zip is a subset of
  308. emxrt.zip, the emx runtime package, plus rsx.  emx and rsx are DOS
  309. extenders which are used by 32-bit programs.  emx is for DOS
  310. configurations without DPMI (DOS Protected Mode Interface), rsx is for
  311. DOS configurations which employ DPMI (MS Windows, for instance).  emx
  312. also includes files required for running the 32-bit programs under
  313. OS/2 2.x and OS/2 3 Warp.  However, 32-bit programs cannot be run
  314. under OS/2 1.x, whatever CPU you have.
  315.  
  316. To install package `emxrsx', unpack emxrsx.zip and follow the
  317. instructions in \emx\doc\emxrt.doc (under OS/2, you can read a nicer
  318. version of that text by typing `view \emx\book\emxrt').  Here's what
  319. to do, in a nutshell:
  320.  
  321. - Add c:\emx\bin to PATH (config.sys or autoexec.bat)
  322.  
  323. - Under OS/2, add c:\emx\dll to the LIBPATH statement of config.sys
  324.  
  325. - Under DOS, remove BREAK=ON from config.sys
  326.  
  327. - Reboot
  328.  
  329. Special care must be taken if you already have emx.dll on your OS/2
  330. system.  See emxrt.doc (or emxrt.inf) for details.
  331.  
  332.  
  333. 3. Installing the TeX compiler
  334. ------------------------------
  335.  
  336. To use TeX, unpack tex4b.zip.  tex386 and htex386 require emxrsx.zip,
  337. see above.  In addition to TeX, you need font metric files (TFM files)
  338. which are contained in fontcm.zip.  The plain TeX macros are shipped
  339. in tex4b.zip.
  340.  
  341. If you want to use LaTeX2e, unpack l2input.zip.  If you want to use
  342. LaTeX 2.09, unpack latex209.zip.  (You can install both.)  As both
  343. LaTeX2e and LaTeX 2.09 require the LaTeX fonts, unpack fontltx.zip.
  344. To use German hyphenation patterns and macros for German language
  345. support, unpack german.zip.
  346.  
  347. IMPORTANT: See \emtex\doc\english\tex.doc for further installation
  348. instructions (OS/2 users can type `view tex'), including how to create
  349. format files.
  350.  
  351. Typically, you'll create format files for plain TeX and LaTeX2e with
  352. US English hyphenation patterns, for use with tex386.exe:
  353.  
  354.     cd \emtex\btexfmts
  355.     makefmt 386 plain US
  356.     makefmt 386 latex2e US 8bit -b \emtex\bin\latex2e
  357.  
  358. IMPORTANT: See \emtex\doc\english\tex.doc for details (OS/2 users can
  359. type `view tex').
  360.  
  361. Package l2tools contains additional macros for LaTeX2e.  After
  362. creating format files and after unpacking l2tools.zip, type
  363.  
  364.     cd \emtex\dist\latex\packages\tools
  365.     latex2e tools.ins
  366.  
  367. (latex2e is the name of the batch file for invoking LaTeX2e, created
  368. by makefmt) and copy some files to the LaTeX2e input directory:
  369.  
  370.     copy *.tex \emtex\texinput\latex2e
  371.     copy *.sty \emtex\texinput\latex2e
  372.  
  373. If you don't use LaTeX 2.09, you might want to copy the files to their
  374. own subdirectory, such as \emtex\texinput\tools2e.
  375.  
  376. See \emtex\dist\latex\packages\tools\readme.txt for further details.
  377. The file manifest.txt in the same directory contains a list of macro
  378. packages provided by l2tools.  After copying the files, you can save
  379. some disk space by deleting files in \emtex\dist\latex\packages\tools.
  380.  
  381. texware.zip contains various tools for TeX: texchk (a syntax checker
  382. for LaTeX 2.09), texconv (convert accented characters), DVItype (lists
  383. and checks DVI files) PLtoTF and TFtoPL (convert and check TFM files),
  384. VFtoVP and VPtoVF (convert and check virtual font files).
  385.  
  386.  
  387. 4. Installing METAFONT
  388. ----------------------
  389.  
  390. To use METAFONT, mf4b.zip (METAFONT proper) and mfjob12c.zip (assists
  391. METAFONT in generating fonts) should be unpacked.  mf386 requires
  392. emxrsx.zip, see above.
  393.  
  394. You also need some or all font source files from fontcm.zip,
  395. fontdc.zip, fontltx.zip, fontams.zip, and fontemsy.zip.
  396.  
  397. IMPORTANT: See \emtex\doc\english\metafont.doc for further
  398. installation instructions (OS/2 users can type `view metafont'),
  399. including how to create base files.
  400.  
  401. Typically, you'll create a base file for plain METAFONT, for use with
  402. mf386.exe:
  403.  
  404.     cd \emtex\bmfbases
  405.     makebas 386 plain
  406.  
  407. IMPORTANT: See \emtex\doc\english\metafont.doc for details (OS/2 users
  408. can type `view metafont').  For instance mfpm.ovl requires additional
  409. settings.
  410.  
  411. See \emtex\doc\english\mfjob.doc and \emtex\doc\english\mfware.doc for
  412. further information on MFjob and METAFONT's companion tools.
  413.  
  414. mfware.zip contains tools for converting between font file formats and
  415. other font-related tools.  You don't have to install mfware.zip unless
  416. you want to design fonts yourself or you need the documentation for
  417. gftopk.exe.
  418.  
  419. METAFONT is not quite perfect in generating fonts at very low
  420. resolutions.  To correct METAFONT's errors manually, a font editor is
  421. provided in pkedit.zip.  See \emtex\doc\english\pkedit.doc and
  422. \emtex\doc\pkeditpm.doc for details.  pkeditpm requires emxrsx.zip,
  423. see above.  Moreover, pkeditpm requires emdll1x.dll, emdll1x2.dll,
  424. and emdll2x.dll which are shipped in dvid16e1.zip.
  425.  
  426.  
  427. 5. Installing the printer drivers, screen previewers, and fonts
  428. ---------------------------------------------------------------
  429.  
  430. To install the DVI drivers, unpack both dvid16e1.zip and dvid16e2.zip.
  431. dvipm requires emxrsx.zip, see above.
  432.  
  433. IMPORTANT: See \emtex\doc\english\dvidrv.doc for further installation
  434. instructions (OS/2 users can type `view dvidrv').
  435.  
  436. The DVI drivers need pixel fonts.  Pixel fonts for emTeX are shipped
  437. in font library files (.FLI files).  The following font library files
  438. are available:
  439.  
  440.     bj_base.fli         Base fonts for the Canon BubbleJet (360 DPI)
  441.     dj_base.fli         Base fonts for the HP DeskJet (300 DPI)
  442.     fax_base.fli        Base fonts for Fax (204x196 DPI)
  443.     fx_base.fli         Base fonts for 9-pin printers (240x216 DPI)
  444.     ito_base.fli        Base fonts for the C.ITOH 8510A (160x144 DPI)
  445.     ljh_base.fli        Base fonts for the HP LaserJet 4 (600 DPI)
  446.     lj_base.fli         Base fonts for the HP LaserJet (300 DPI)
  447.     p6h_base.fli        Base fonts for 24-pin printers (360 DPI)
  448.     p6l_base.fli        Base fonts for 24-pin printers (180 DPI)
  449.     p6m_base.fli        Base fonts for 24-pin printers (360x180 DPI)
  450.     qj_base.fli         Base fonts for the HP QuietJet (192 DPI)
  451.     sty_base.fli        Base fonts for the EPSON Stylus 800 (360 DPI)
  452.  
  453. As those font library files don't contain all fonts in all possible
  454. sizes (and as you might not have any font library files at all), the
  455. DVI drivers automatically call MFjob and METAFONT for generating
  456. missing fonts as needed.  Therefore, you should also install METAFONT,
  457. see above.
  458.  
  459. All examples assume that you use directory c:\texfonts for fonts.
  460. Therefore it is recommended to copy the appropriate font library file
  461. to c:\texfonts and to let the DVIDRVFONTS environment variable point
  462. to that directory.
  463.  
  464. By default, new fonts generated by MFjob are placed in directory
  465. c:\newfonts (unless MFjob is called automatically by a DVI driver).
  466. If you want to use a different directory, modify the `def target='
  467. statement of \emtex\mfjob\modes.mfj.  When called by a DVI driver,
  468. Mfjob uses the first directory listed in the DVIDRVFONTS environment
  469. variable.
  470.  
  471. If you don't have the base fonts and you want to generate the base
  472. fonts now, modify the `output' statements of \emtex\mfjob\modes.mfj,
  473. replacing `c:\newfonts' with your font directory, such as
  474. `c:\texfonts'.  Install fontcm.zip and fontltx.zip.  Then, type
  475.  
  476.     mfjob base m=MODE
  477.     fli_base PREFIX RES c:\texfonts
  478.  
  479. where MODE, PREFIX, and RES depend on the font set:
  480.  
  481.     MODE | PREFIX | RES | Font library | Description
  482.     -----+--------+-----+--------------+-------------------------
  483.     bj   | bj     | 360 | bj_base.fli  | Canon BubbleJet (360 DPI)
  484.     dj   | dj     | 300 | dj_base.fli  | HP DeskJet (300 DPI)
  485.     FAX  | fax    | 204 | fax_base.fli | Fax (204x196 DPI)
  486.     fx   | fx     | 240 | fx_base.fli  | 9-pin printers (240x216 DPI)
  487.     ito  | ito    | 160 | ito_base.fli | C.ITOH 8510A (160x144 DPI)
  488.     lj   | lj     | 300 | lj_base.fli  | HP LaserJet (300 DPI)
  489.     ljh  | ljh    | 600 | ljh_base.fli | HP LaserJet 4 (600 DPI)
  490.     lqh  | p6h    | 360 | p6h_base.fli | 24-pin printers (360 DPI)
  491.     lql  | p6l    | 180 | p6l_base.fli | 24-pin printers (180 DPI)
  492.     lqm  | p6m    | 360 | p6m_base.fli | 24-pin printers (360x180 DPI)
  493.     qj   | qj     | 192 | qj_base.fli  | HP QuietJet (192 DPI)
  494.     sty  | sty    | 360 | sty_base.fli | EPSON Stylus 800 (360 DPI)
  495.  
  496. If you are not sure, you can take the appropriate pair of lines from
  497. \emtex\bin\makefli.bat (don't forget to update the font directory).
  498.  
  499. To let MFjob call mf386, use the /3 option.  It is recommended to set
  500. this option in the MFJOBOPT environment variable:
  501.  
  502.     set mfjobopt=/3
  503.  
  504. (Do this before calling MFjob.)  For low-resolution fonts such as
  505. `ito', you should use the /i option of MFjob to let it continue after
  506. METAFONT reports an error:
  507.  
  508.     mfjob base /i m=ito
  509.     fli_base ito 160 c:\texfonts
  510.  
  511. After creating the .FLI file with `fli_base', you can delete the .pk
  512. files from the subdirectories of the font directory, for instance:
  513.  
  514.     emdelete -r c:\texfonts\pixel.lj
  515.  
  516. As the default font configuration files look for both PREFIX_base.fli
  517. and PREFIX_more.fli (you can put local fonts into PREFIX_more.fli),
  518. the drivers will display a warning message if PREFIX_more.fli does not
  519. exist.  To avoid that warning without modifying the configuration
  520. files (you should not modify the configuration files), create a dummy
  521. font library file:
  522.  
  523.     cd \texfonts
  524.     fontlib /c PREFIX_more
  525.  
  526. To check whether downloaded copies of the FLI files are undamaged, use
  527. the fontlib command:
  528.  
  529.     cd \texfonts
  530.     fontlib /t PREFIX_base
  531.  
  532.  
  533. 6. Installing MakeIndex
  534. -----------------------
  535.  
  536. MakeIndex is a tool for generating an index for a LaTeX document.  To
  537. install MakeIndex, unpack makeindx.zip.  For processing big indexes, a
  538. 32-bit version, mkidx32.exe, is provided.  mkidx32.exe requires
  539. emxrsx.zip, see above.
  540.  
  541. You'll find the MakeIndex documentation in \emtex\doc\makeindx.doc and
  542. \emtex\texinput\latex209\makeindx.tex.
  543.  
  544. To use MakeIndex style files, you have to set the INDEXSTYLE
  545. environment variable to point to the directory containing the style
  546. files:
  547.  
  548.     set indexstyle=c:\emtex\idxstyle
  549.  
  550. You can find the source code for MakeIndex in srcmkidx.zip.
  551.  
  552.  
  553. 7. Installing BibTeX
  554. --------------------
  555.  
  556. BibTeX manages bibliography databases for LaTeX.  To install BibTeX,
  557. unpack bibtex4b.zip.  bibtex32 requires emxrsx.zip, see above.
  558.  
  559. See \emtex\doc\bibtex.doc for further information.
  560.  
  561.  
  562. 8. Installing TeXcad
  563. --------------------
  564.  
  565. Georg Horn's TeXcad is an interactive designer for LaTeX pictures.  To
  566. install TeXcad, unpack texcad.zip.
  567.  
  568. If TeXcad asks for the path of a BGI device driver file, enter
  569. c:\emtex\bin.  Then, configure the BGI directory (choose
  570. Options->Directories->BGI-Directory from the menu), and save the
  571. options in the file c:\emtex\bin\texcad.opt.
  572.  
  573. You can find the source code for TeXcad in srctcad.zip.
  574.  
  575.  
  576. 9. Installing dvispell
  577. ----------------------
  578.  
  579. dvispell converts DVI files into plain text files.  Originally,
  580. dvispell was designed for preparing DVI files for spell-checking.
  581. However, there are lots of other possible uses.  To install dvispell,
  582. unpack dvisp10b.zip and type
  583.  
  584.     dvisprep c:\emtex\data\plain.dsi
  585.  
  586. You'll find documentation in \emtex\doc\english\dvispell.doc (OS/2
  587. users can type `view dvispell').
  588.  
  589.  
  590. 10. Installing PiCTeX
  591. ---------------------
  592.  
  593. The PiCTeX macro package is shipped in pictex.zip.  You can obtain the
  594. PiCTeX manual (US$30) from the TeX User's Group:
  595.  
  596.     TeX Users Group
  597.     1850 Union Street, #1637
  598.     San Francisco, CA 94123 (USA)
  599.     Phone: 1 415 982 8449
  600.     FAX: 1 415 982 8559
  601.     tug@tug.org
  602.  
  603.  
  604. 11. Installing WEB
  605. ------------------
  606.  
  607. WEB is a system for literate programming in Pascal.  TeX, METAFONT,
  608. and a lot of other programs are written in WEB.  To install the WEB
  609. tools, unpack web.zip.  See \emtex\doc\english\web.doc for further
  610. information.
  611.  
  612.  
  613. 12. Viewing and printing additional documentation
  614. -------------------------------------------------
  615.  
  616. After installing TeX, METAFONT, and the DVI drivers, you can view or
  617. print manuals which are available as TeX or DVI files.
  618.  
  619. The file \emtex\doc\latex209\local.dvi (of latex209.zip) contains the
  620. local guide for LaTeX 2.09.
  621.  
  622. The file \emtex\dist\latex\base\usrguide.tex (of l2base.zip) contains
  623. the document `LaTeX2e for authors'.  To typeset that document
  624. (creating usrguide.dvi), type the following commands:
  625.  
  626.     cd \emtex\dist\latex\base
  627.     latex2e usrguide
  628.     latex2e usrguide
  629.     latex2e usrguide
  630.  
  631. A short introduction to LaTeX 2.09 written in German is available in
  632. file \emtex\doc\lkurz.dvi of lkurz.zip.
  633.  
  634. A short introduction to LaTeX2e written in German is available in file
  635. \emtex\doc\l2kurz.dvi of l2kurz.zip.
  636.  
  637. The file \emtex\doc\germdoc.dvi (of german.zip) contains the
  638. documentation for german.sty.
  639.  
  640. The file \emtex\doc\english\tcman.dvi (of texcad.zip) contains the
  641. documentation for TeXcad.
  642.  
  643.  
  644. ------------------------------------------------------------------------------
  645. Installing emTeX in a different directory
  646. ------------------------------------------------------------------------------
  647.  
  648. The `emtex' directory need not be in the root directory.  For
  649. instance, you can use \local\emtex as root for the emTeX directory
  650. tree.  To unpack a ZIP archive file into that directory structure,
  651. type (for instance):
  652.  
  653.     cd \local
  654.     unzip a:\first
  655.  
  656. The environment variables have to be adjusted:
  657.  
  658.     set emtexdir=c:\local\emtex
  659.  
  660. Don't forget to adjust PATH, HELP, BOOKSHELF, and LIBPATH!
  661.  
  662. To install emTeX in, say, \tex (that is, \tex\bin, \tex\texinput,
  663. etc.), unpack emTeX into \emtex and then rename \emtex to \tex.
  664.  
  665. It is not recommended to change the structure of the emTeX directory
  666. tree as that requires setting a lot of environment variables such as
  667. TEXINPUT (in contrast to setting only EMTEXDIR).
  668.  
  669.  
  670. ------------------------------------------------------------------------------
  671. Removing a package
  672. ------------------------------------------------------------------------------
  673.  
  674. You can remove a package from the hard disk if the appropriate REM
  675. file is supplied.  If, for example, you want to remove the TEXWARE
  676. package from drive C: you would enter the following commands:
  677.  
  678.     emremove c:\emtex\remove\texware.rem c:\
  679.  
  680. where
  681.  
  682.     emremove    run the package removal program (from c:\emtex\bin)
  683.     c:\emtex\remove\texware.rem
  684.                 the list of files comprising the package
  685.     c:\         remove the package from this directory
  686.  
  687. If you have installed the emTeX directory tree in, say, c:\local (that
  688. is, in directories c:\local\emtex\bin, c:\local\emtex\texinput, etc.),
  689. type this:
  690.  
  691.     emremove c:\local\emtex\remove\texware.rem c:\local
  692.  
  693. If the top-level directory of the emTeX directory tree is not named
  694. `emtex', you cannot use `emremove' unless you either rename the
  695. directory to `emtex' or edit the .rem files.
  696.  
  697.  
  698. ------------------------------------------------------------------------------
  699. Unpacking LaTeX2e
  700. ------------------------------------------------------------------------------
  701.  
  702. The original LaTeX2e distribution is shipped in l2base.zip.  That
  703. archive contains a lot of documentation files and the LaTeX source
  704. files packaged in .dtx files.
  705.  
  706. If you want to unpack LaTeX2e yourself (instead of installing
  707. l2input.zip), type the following commands after unpacking l2base.zip:
  708.  
  709.     cd \emtex\dist\latex\base
  710.     tex386 /i unpack.ins
  711.     latex2e autoload.ins
  712.     inst2e \emtex
  713.  
  714. Instead of tex386, you might have to use one of the other emTeX
  715. executables, such as tex or texp.  Note that this procedure does not
  716. create format files, therefore it does not matter what executable you
  717. apply to unpack.ins (the faster the better, however).  Instead of
  718. `latex2e' you can use TeX with plain.fmt; INITEX won't work.
  719.  
  720. The `inst2e' batch file copies the files required for running LaTeX2e
  721. to the `texinput\latex2e' and `idxstyle' subdirectories of the
  722. directory given as argument.  If directories `\emtex\texinput\latex2e'
  723. or `\emtex\idxstyle' already exist, you'll get one or two error
  724. messages indicating that directories could not be created.  Ignore
  725. these error messages but not any other error messages.
  726.  
  727. After unpacking LaTeX2e and running `inst2e', you can save some disk
  728. space by deleting files in \emtex\dist\latex\base.  However, you
  729. might want to read the documentation files in that directory first.
  730.  
  731. If you want to delete the files from \emtex\texinput\latex2e when
  732. installing a new version of LaTeX2e, either delete the files before
  733. applying TeX to the *.ins files or after running `inst2e'. If you
  734. delete the files between those two steps, texsys.cfg will be missing.
  735.  
  736. You can find further information on installation of LaTeX2e in
  737. \emtex\dist\latex\base\install.txt.
  738.  
  739.  
  740. ------------------------------------------------------------------------------
  741. Sample autoexec.bat for DOS
  742. ------------------------------------------------------------------------------
  743.  
  744. This is but an excerpt, do not overwrite your autoexec.bat file with
  745. this sample!  You don't have to use upper-case letters.
  746.  
  747. SET PATH=C:\DOS;C:\APPS;C:\EMX\BIN;C:\EMTEX\BIN
  748. SET EMTEXDIR=C:\EMTEX
  749. SET DVIDRVFONTS=C:\TEXFONTS
  750. SET INDEXSTYLE=C:\EMTEX\IDXSTYLE
  751. SET MFJOBOPT=/3
  752. SET TMP=C:\TMP
  753. SET EMTEXED=q %%2 -n%%1
  754.  
  755.  
  756. ------------------------------------------------------------------------------
  757. Sample config.sys for OS/2
  758. ------------------------------------------------------------------------------
  759.  
  760. This is but an excerpt, do not overwrite your config.sys file with
  761. this sample!  You don't have to use upper-case letters.
  762.  
  763. LIBPATH=C:\OS2\DLL;C:\OS2\MDOS;C:\OS2\APPS\DLL;C:\EMX\DLL;C:\EMTEX\DLL;
  764. SET PATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS;C:\OS2\APPS;C:\EMX\BIN;C:\EMTEX\BIN
  765. SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;C:\EMTEX\HELP
  766. SET BOOKSHELF=C:\OS2\BOOK;C:\EMX\BOOK;C:\EMTEX\BOOK\ENGLISH
  767. SET EMTEXDIR=C:\EMTEX
  768. SET DVIDRVFONTS=C:\TEXFONTS
  769. SET INDEXSTYLE=C:\EMTEX\IDXSTYLE
  770. SET MFJOBOPT=/3
  771. SET TMP=C:\TMP
  772. SET EMTEXED=emacsclient +%1 %2
  773. IOPL=YES
  774.  
  775.                   -------- End of INSTALL.ENG -------------
  776.