home *** CD-ROM | disk | FTP | other *** search
/ Dream 46 / Amiga_Dream_46.iso / os2 / Latex / help.eng < prev    next >
Encoding:
Text File  |  1997-11-13  |  36.5 KB  |  1,123 lines

  1. ==============================================================================
  2. HELP.ENG (emTeX DISTRIBUTION)                                      19-Sep-1995
  3. ==============================================================================
  4.  
  5. This file contains frequently asked questions about emTeX and their
  6. answers.  If you have a question which is not here and you cannot find
  7. the answer in the documentation (or it is very difficult to find),
  8. please let me know.
  9.  
  10. If you don't know how to install emTeX, see INSTALL.ENG.
  11.  
  12.  
  13. Contents
  14. ========
  15.  
  16. 1. TeX
  17. 2. DVIDRV
  18. 3. METAFONT
  19. 4. FONTS
  20. 5. Miscellaneous topics
  21.  
  22.  
  23. 1. TeX
  24. ======
  25.  
  26. 1.1:    What's the difference between standard TeX and bigTeX?
  27.  
  28.     `bigTeX' is bigger than `standard TeX' (and much slower).  If TeX
  29.     runs out of memory, try bigTeX.  If you have a 386 or better CPU
  30.     use tex386.exe instead of btex*.exe -- it's faster and provides
  31.     more space for strings (pool size).
  32.  
  33.  
  34. 1.2:    TeX says:
  35.  
  36.           Fatal format file error; I'm stymied
  37.  
  38.         What shall I do?
  39.  
  40.     You are trying to use a format file of a different TeX version
  41.     (for instance, standard vs. big, or 3.14 vs. 3.14159).  Note that
  42.     the big emTeX versions including tex386 use the BTEXFMT
  43.     environment variable.  The standard-sized versions use the TEXFMT
  44.     environment variable.  (Also note that usually you don't have to
  45.     set these environment variables.)  Perhaps you forgot to use the
  46.     `386' keyword of makefmt when creating a format file for
  47.     tex386.exe.
  48.  
  49.     If the error message includes
  50.  
  51.       Must increase the trie size
  52.  
  53.     you forgot to use the /mt option.  For both creating and using a
  54.     FMT file with a non-standard trie size, you have to use the /mt
  55.     option.  Putting it into the environment variable EMTEXOPT is a
  56.     convenient method for achieving this.  The makefmt tool optionally
  57.     creates a batch file; that batch file uses the optimal value for
  58.     the /mt option.  See \emtex\doc\english\tex.doc for details.
  59.  
  60.  
  61. 1.3:    TeX says:
  62.  
  63.           I can't find the PLAIN format file!
  64.  
  65.         What's wrong?
  66.  
  67.     You forgot to create the plain format file (plain.fmt) or emTeX
  68.     cannot find it.  Use makefmt to create the format file (see
  69.     INSTALL.ENG, QUICK.ENG and \emtex\doc\english\tex.doc for
  70.     details).  Be careful to do this in the correct directory.
  71.     Usually you should not set the TEXFMT, BTEXFMT, and HTEXFMT
  72.     environment variables.
  73.  
  74.  
  75. 1.4:    When trying to use LaTeX, the error message
  76.  
  77.           ! Undefined control sequence.
  78.           l.1 \documentclass
  79.  
  80.         or
  81.  
  82.           ! Undefined control sequence.
  83.           l.1 \documentstyle
  84.  
  85.         is displayed.  What's wrong?
  86.  
  87.     Apparently, TeX is using the PLAIN format instead of the LaTeX
  88.     format.  You have to tell TeX to use the LaTeX format.  Invoke the
  89.     batch file created by makefmt instead of TeX proper and make sure
  90.     that the LaTeX format file does exist and can be found (see the
  91.     answer to question 1.2).
  92.  
  93.  
  94. 1.5:    makefmt complains about `plain.tex' not being installed.
  95.         What's wrong?
  96.  
  97.     As mentioned by INSTALL.ENG, you should unset the TEXINPUT
  98.     environment variable.  If you need TEXINPUT, don't forget to add
  99.     `!' to the end of the path of emTeX's `texinput' directory.
  100.  
  101.  
  102. 1.6:    makefmt cannot find `makefmt.dat'.  What's wrong?
  103.  
  104.     You have not correctly set the EMTEXDIR environment variable.
  105.     Note that the value must be the pathname of a single directory,
  106.     without `;', `!', and `!!'.  There must be no spaces at the end.
  107.     It must point to the emTeX directory.  Example:
  108.  
  109.       set emtexdir=c:\emtex
  110.  
  111.  
  112. 1.7:    When will a TeX-XeT or TeX--XeT variant of emTeX be available?
  113.  
  114.     emTeX won't become a TeX-XeT, which has been superseded by
  115.     TeX--XeT.  TeX--XeT creates standard DVI files, in contrast to
  116.     TeX-XeT which creates IVD files, requiring special DVI drivers or
  117.     an intermediate step for converting to DVI format.
  118.  
  119.     TeX-XeT and TeX--XeT are special variants of TeX capable of
  120.     left-to-right and right-to-left (for Hebrew etc.) typesetting.  I
  121.     don't know whether and when I'll make a TeX--XeT.
  122.  
  123.  
  124. 1.8:    Why is tex386.exe slower than tex.exe on my machine?
  125.  
  126.     If there isn't enough memory, tex386.exe swaps to disk.  Don't use
  127.     all your extended memory for caching or as virtual disk!
  128.  
  129.  
  130. 1.9:    How can I run tex386 under Windows without opening a DOS
  131.         window?
  132.  
  133.     Fetch /tex-archive/systems/msdos/dpmigcc/rsxwin3.zip from CTAN.
  134.  
  135.  
  136. 1.10:    Why doesn't the /mm# option work for me?
  137.  
  138.     TeX's main memory is divided into two parts, one for `small'
  139.     things and one for `big' things.  Only the size for `small' things
  140.     is affected by /mm#.  Unfortunately, in most cases you run out of
  141.     space for `big' things.
  142.  
  143.  
  144. 1.11:   I have seen emTeX described as very fast but I find that
  145.         abcTeX is much faster processing the file xyz.tex! Why is
  146.         that?
  147.  
  148.     emTeX's speed depends heavily on the amount of memory available.
  149.     If there is not much spare memory then it can happen that another
  150.     TeX, which cannot run the large TeX files that emTeX can, will be
  151.     faster.
  152.  
  153.  
  154. 1.12:   There is no INITEX with emTeX, what can I do?
  155.  
  156.     INITEX *is* there, use `tex /i'.  Note that the /i option must
  157.     precede any other arguments.  See \emtex\doc\english\tex.doc for
  158.     details.
  159.  
  160.  
  161. 1.13:   TeX displays the error message
  162.  
  163.           ! TeX capacity exceeded, sorry [buffer size=2048].
  164.  
  165.         How can I prevent this?
  166.  
  167.     Some text processing packages write complete paragraphs as one
  168.     line to the text file.  If a paragraph contains, say, 3000
  169.     characters, the line will contain 3000 characters, without regard
  170.     to the appearance of the paragraph on the display.  Remedy: Most
  171.     of those text processing packages offer an option for writing the
  172.     file formatted, i.e., line by line.
  173.  
  174.  
  175. 1.14:   What's the difference between between TeX, emTeX, and LaTeX?
  176.  
  177.     TeX is a program for typesetting texts.  emTeX is an
  178.     implementation of TeX for OS/2 and DOS.  LaTeX is a macro package
  179.     for TeX (and can therefore be used with emTeX).
  180.  
  181.  
  182. 1.15:   What's the difference between LaTeX, LaTeX 2.09, and LaTeX2e?
  183.  
  184.     LaTeX 2.09 is Leslie Lamport's original macro package which is no
  185.     longer supported.  LaTeX2e is the successor to LaTeX 2.09,
  186.     produced by the LaTeX3 project.  LaTeX formerly referred to LaTeX
  187.     2.09, nowadays it means LaTeX2e.
  188.  
  189.  
  190. 1.16:   Directly entered accented characters do not work with LaTeX2e.
  191.         What's wrong?
  192.  
  193.     If you get the error message
  194.  
  195.       ! Text line contains an invalid character.
  196.  
  197.     you should recreate the format file using makefmt's `8bit'
  198.     keyword.
  199.  
  200.     If there are no error messages on the screen, you should use
  201.  
  202.       \usepackage[cp850]{inputenc}
  203.  
  204.     in your documents.  (The LOG file of the failed TeX run contains
  205.     lines like
  206.  
  207.       Missing character: There is no ^^84 in font cmr10!
  208.  
  209.     in this case.)
  210.  
  211.  
  212. 1.17:   Why can emTeX not use the format files created by other versions
  213.         of TeX?
  214.  
  215.     Format files are implementation dependent, for instance, the sizes
  216.     of the different memory areas, hash size etc.  You are very
  217.     unlikely to find two implementations which can use the same format
  218.     files!
  219.  
  220.  
  221. 1.18:   When I try and print DVI files generated by TeX on another
  222.         machine, the printer driver says they are invalid.
  223.  
  224.     This usually arises from corruption while transferring the data --
  225.     uuencode/uudecode or xxencode/xxdecode will solve the problem.
  226.     DVI files are portable between different TeX implementations and
  227.     between different machines.
  228.  
  229.  
  230. 1.19:   I would like to run my text through a spelling checker (style
  231.         checker).
  232.  
  233.     Feed the DVI into dvispell and run the spelling checker on
  234.     dvispell's output.
  235.  
  236.  
  237. 1.20:   emTeX generates a DVI file which differs from that produced by
  238.         another implementation though the input file was the same and
  239.         the printed output is identical.
  240.  
  241.     That may be expected.  The optimization of position changes
  242.     depends on the size of the DVI file buffer -- and it need not be
  243.     done at all.  In addition, in some places, floating point
  244.     arithmetic is allowed and used (\leaders).  Floating point
  245.     precision differs from machine to machine.
  246.  
  247.  
  248. 1.21:   TeX breaks words after the first letter, for instance, T-est!
  249.  
  250.    You are using a macro package which is not written for TeX 3.0.
  251.    You should recreate the format file and this time set
  252.    \lefthyphenmin and \righthyphenmin appropriately for the
  253.    hyphenation patterns being used.
  254.  
  255.  
  256. 1.22:   TeX displays the following message (when run under DOS):
  257.  
  258.           Please insert diskette containing TEX.EXE into drive x press
  259.           any key to continue
  260.  
  261.     Increase the value for FILES= in config.sys.
  262.  
  263.  
  264. 1.23:   Where's german.tex?
  265.  
  266.     Use german.sty instead.
  267.  
  268.  
  269. 1.24:   How do I run LaTeX?  There is no latex.exe!
  270.  
  271.     See \emtex\doc\english\install.eng for instructions on
  272.     installation of LaTeX.  See \emtex\doc\english\tex.doc on how to
  273.     create a format file for LaTeX with the makefmt tool; makefmt will
  274.     also create a batch file (say, latex.bat) for running LaTeX.
  275.  
  276.  
  277. 1.25:   How do I install AMSTeX?
  278.  
  279.     See the installation instructions of AMSTeX.  (emTeX does not
  280.     include AMSTeX; however, you can get it from CTAN.)
  281.  
  282.  
  283. 1.26:   How can I make emTeX look for TFM files in the current directory?
  284.  
  285.     Set the TEXTFM environment variable to include `.' and the usual
  286.     TFM directories:
  287.  
  288.       set textfm=.;c:\emtex\tfm!
  289.  
  290.  
  291. 1.27:   Running tex386.exe or htex386.exe yields the error message
  292.  
  293.           emx not found
  294.  
  295.         What's wrong?
  296.  
  297.     You forgot to add the directory c:\emx\bin to the PATH (or you
  298.     forgot to reboot after making that change).  If you don't want to
  299.     list that directory in the PATH, let the EMX environment variable
  300.     point to the emx.exe file:
  301.  
  302.       set emx=c:\emx\bin\emx.exe
  303.  
  304.     (Use the correct drive letter, as usual.)
  305.  
  306.  
  307. 1.28:   Running tex386.exe or htex386.exe yields the error message
  308.  
  309.           SYS1804: The system cannot find the file EMX.
  310.  
  311.         What's wrong?
  312.  
  313.     You forgot to add the directory c:\emx\dll to the LIBPATH
  314.     statement of config.sys (or you forgot to reboot after making that
  315.     change).
  316.  
  317.  
  318. 1.29:   How can I avoid emTeX saying
  319.  
  320.           ! I can't write on file `xxx.dvi'.
  321.  
  322.         when I try to run emTeX while dvipm displays xxx.dvi?
  323.  
  324.     In dvipm, select File->New or File->Auto_reload.
  325.  
  326.  
  327. 1.30:   tex386.exe says
  328.  
  329.           Usage: emx [-cdeoOV] ...
  330.  
  331.         What's wrong?
  332.  
  333.     You have an out-dated version of emx.exe somewhere in your PATH.
  334.     Delete it and keep \emx\bin\emx.exe of emxrsx.zip.
  335.  
  336.  
  337. 1.31:   How can I preload a TeX format, i.e., create an EXE file
  338.         containing a format file?
  339.  
  340.     That isn't supported by emTeX because it isn't useful in my
  341.     opinion.
  342.  
  343.  
  344. 1.32:   Has emTeX passed the trip test?
  345.  
  346.     Yes.
  347.  
  348.  
  349. 1.33:   TeX crashes (I am using a somewhat unusual memory card).
  350.  
  351.     Use the /d option when running TeX.
  352.  
  353.  
  354. 1.34:   How can I run tex386.exe and htex386.exe under Windows or in a
  355.         DOS window of OS/2?  The programs say `DYN: out of memory'.
  356.  
  357.     Increase the DPMI memory limit of Windows or of the DOS window.
  358.  
  359.  
  360. 2. DVIDRV
  361. =========
  362.  
  363. General
  364. -------
  365.  
  366. 2.1:    I have a PostScript printer but emTeX does not have a suitable
  367.         driver.  Where can I find a suitable driver?
  368.  
  369.     Use Tomas Rokicki's dvips.  It has been ported to OS/2 and DOS and
  370.     is for anonymous ftp on CTAN hosts, in directory
  371.     /tex-archive/systems/msdos/dviware/drivers/dvips558.pc.  dvips can
  372.     use emTeX's font library files.
  373.  
  374.  
  375. 2.2:    Automatic generating of missing fonts does not work.  METAFONT
  376.         generates a GF file (but no TFM file) which GFtoPK does not
  377.         find, or MFjob complains about not being able to move a TFM
  378.         file.  What's wrong?
  379.  
  380.     If MFjob calls GFtoPK with a file name that has a long extension
  381.     (say, cmr10.300gf), but METAFONT has created a file with a
  382.     truncated extension (say, cmr10.300), try the /z option of MFjob:
  383.  
  384.       set mfjobopt=/z
  385.  
  386.     (Don't forget to include the previous value of MFJOBOPT!)
  387.  
  388.     Check the EMXOPT environment variable: It must not contain `-t'.
  389.  
  390.     If MFjob calls GFtoPK with a file name that has a truncated
  391.     extension (say, cmr10.300), but METAFONT has created a file with a
  392.     long extension (say, cmr10.300gf), you have erroneously used
  393.     MFjob's /z option, probably in the MFJOBOPT environment variable.
  394.  
  395.     If that does not help, it is very likely that you have ignored the
  396.     installation instructions.  Either you have not deleted the \emtex
  397.     directory tree of a previous emTeX release (causing METAFONT to
  398.     load an out-dated local.mf file), or you have not created new base
  399.     files.
  400.  
  401.     You can find instructions for creating base files in
  402.     \emtex\doc\english\metafont.doc.
  403.  
  404.     The correct local.mf file is in \emtex\mfinput\etc, the old one is
  405.     in \emtex\mfinput.  If you have \emtex\mfinput\local.mf, you
  406.     should delete the entire emTeX directory tree and reinstall the
  407.     latest version.
  408.  
  409.     Check the LOG file (typically \emtex\bmfbases\plain.log) written
  410.     by METAFONT when the base file was created: It should contain
  411.  
  412.       (c:\emtex\mfinput\etc\local.mf)
  413.  
  414.     but not
  415.  
  416.       (c:\emtex\mfinput\local.mf)
  417.  
  418.     Note that some METAFONT modes have been renamed.  Check that the
  419.     CNF files (e.g., lj.cnf) used by the DVI driver contain the
  420.     correct (new) METAFONT mode in the line starting with
  421.     `+metafont-mode' (if there is a line starting with `/fm', please
  422.     install the latest version of the DVI drivers).  Also check that
  423.     the file \emtex\mfjob\modes.mfj uses the correct (new) METAFONT
  424.     modes.  If there is a mismatch, there is perhaps a version
  425.     mismatch (or you use your own CNF files).  Please update the DVI
  426.     drivers, MFjob, and METAFONT to the latest version.
  427.  
  428.     If the problem occurs with dvips, config.ps should be changed to
  429.     use the new METAFONT modes of local.mf.  Check the line starting
  430.     with `M'.
  431.  
  432.     The following table shows the old and the corresponding new
  433.     METAFONT modes:
  434.  
  435.       Old METAFONT mode  |  New METAFONT mode
  436.       -------------------+--------------------
  437.       hplaser            |  laserjet or deskjet
  438.       kyocera            |  laserjet
  439.       hpquiet            |  quietjet
  440.  
  441.  
  442. 2.3:    The driver won't find the font after generating a missing
  443.         font.  Why?
  444.  
  445.     That's a rounding problem which should have been fixed in version
  446.     1.6a.  If you still experience that problem, add the size of the
  447.     font as generated by MFjob to the list of font sizes searched by
  448.     the driver.  For instance, if the driver wants cmr10<746.63959>
  449.     and MFjob puts the font into the 746dpi directory (instead of
  450.     747dpi), use
  451.  
  452.       +font-sizes:+746
  453.  
  454.     (You might want to add that option it to the batch file or to the
  455.     configuration file.)
  456.  
  457.  
  458. 2.4:    How can I make MFjob invoke mf386.exe (instead of mf.exe)?
  459.  
  460.     SET MFJOBOPT=/3
  461.  
  462.  
  463. 2.5:    My printer is connected to the serial port and prints nonsense.
  464.  
  465.     You should turn on the XON-XOFF protocol with the +xon-xoff
  466.     parameter giving the port name as COM1, COM2, COM3 or COM4.
  467.  
  468.  
  469. 2.6:    I am using a DVI driver which cannot use font library files,
  470.         do I have to have both the fonts and a font library on my
  471.         disk?
  472.  
  473.     No -- see the answer to question 4.2.
  474.  
  475.  
  476. 2.7:    The driver writes a DLG file (e.g., dviscr.dlg) every time,
  477.         how can I suppress it?
  478.  
  479.     Use the command line option +transcript-file (without a filename).
  480.  
  481.  
  482. 2.8:    I have a PCX file (or MSP file) which doesn't work with
  483.         \special{em:graph}.
  484.  
  485.     Please send the file (and a correct hard copy) to the emTeX author.
  486.     Note that PCX files written by certain programs cannot be
  487.     interpreted unambiguously.  emTeX's DVI drivers rejects those PCX
  488.     files.  Consider using bm2font for including images in TeX
  489.     documents.
  490.  
  491.  
  492. 2.9:    I have inserted a picture using \special{em:graph} exactly as
  493.         the documentation says but it appears too far to the right (or
  494.         too low).
  495.  
  496.     The reason is that many pictures have an empty left or upper
  497.     margin.  To overcome this you can use the following trick -- pass
  498.     these commands through TeX:
  499.  
  500.       \noindent\special{em:graph xxx}\bye
  501.  
  502.     where xxx is the name of the graphics file.  Then convert the DVI
  503.     file into a bitmap file with dvidot, using the +minimize option.
  504.     The +minimize option removes the empty margins.  You can now use
  505.     the resulting bitmap file in your document.
  506.  
  507.  
  508. 2.10:   Graphics inserted with \special{em:graph} appear too small (or
  509.         too large).
  510.  
  511.     The driver copies the picture without altering its size -- if this
  512.     size is wrong then you must use a suitable program to adjust it.
  513.     Consider using bm2font for including images in TeX documents.
  514.  
  515.  
  516. 2.11:   What is bm2font?
  517.  
  518.     bm2font is a program written by Friedhelm Sowa which converts
  519.     bitmaps (many formats) into PK fonts.  It features scaling and
  520.     dithering.  bm2font is available for anonymous ftp on CTAN hosts
  521.     in directory /tex-archive/graphics/bm2font.
  522.  
  523.  
  524. 2.12:   What does the error message
  525.  
  526.           [cannot open dvidrv.err]
  527.  
  528.         mean?
  529.  
  530.     Error messages are read from a file called dvidrv.err.  This file
  531.     must exist in the `data' subdirectory of the emTeX directory.  The
  532.     EMTEXDIR environment variable should point to the emTeX directory.
  533.     If EMTEXDIR is not set, dvidrv.err is assumed to be in
  534.     \emtex\data.  If this file cannot be found then you will get the
  535.     number of the error or warning and you can look up the text in
  536.     dvidrv.doc.
  537.  
  538.  
  539. 2.13:   The driver issues fatal error 2003 if I try to let it print
  540.         directly to a device such as PRN.
  541.  
  542.     This failure is due to a bug in DR-Dos 5.0.  DR-Dos 5.0 cannot
  543.     send a Ctrl-Z character to any device because the IOCTL system
  544.     call which is used to enable output of Ctrl-Z to devices seems to
  545.     be ignored by DR-Dos 5.0.  Even printing to a file and copying
  546.     that file to the device using `copy /b' does not work.  It is
  547.     reported that there is a new version of DR-Dos 5.0 with that bug
  548.     fixed.  Remedy: Obtain that new version, a later version, or use
  549.     OS/2, MS-DOS or PC-DOS.
  550.  
  551.  
  552. 2.14:   The drivers cannot find the fonts circle10 and circlew10.
  553.         What can I do?
  554.  
  555.     See the answer to question 4.10.
  556.  
  557.  
  558. 2.15:   I get the error message
  559.  
  560.           A numeric coprocessor exception occurred and a numeric
  561.           coprocessor exception handler was not registered
  562.  
  563.         with all drivers but dviscrs (note the `s' at the end) and
  564.         dvivik.
  565.  
  566.     This problem should disappear when you remove the (n)nansi.sys
  567.     driver from config.sys.  Currently, I don't know any other remedy.
  568.  
  569.  
  570. 2.16:   I get the error message
  571.  
  572.           A program started an invalid instruction without registering
  573.           an invalid opcode exception handler
  574.  
  575.         with all drivers but dviscrs (note the `s' at the end) and dvivik.
  576.  
  577.     There seems to be a problem with old RAM disk drivers which use
  578.     neither XMS nor EMS.
  579.  
  580.  
  581. 2.17:   How can I send a fax document created with TeX?
  582.  
  583.     Under DOS, use pcxfax.bat to create a PCX file.  Feed that PCX
  584.     file into your fax software.
  585.  
  586.     Under OS/2, use prtfaxwk.cmd to print to a printer port attached
  587.     to FaxWorks.  By default, prtfaxwk.cmd prints to LPT3.
  588.     Alternatively, you can use dvipm (with fax.cnf) to print to the
  589.     FxPrint printer.
  590.  
  591.  
  592. 2.18:   Where can I get a DVI previewer for Windows?
  593.  
  594.     Fetch /tex-archive/dviware/dviwin/dviwin29.zip from CTAN.
  595.  
  596.  
  597. dviscr
  598. ------
  599.  
  600. 2.19:   I have a video adapter which is not supported by dviscr.  What
  601.         can I do?
  602.  
  603.     Send me the hardware and software documentation.  If it is not too
  604.     difficult, then there is a good chance that I will extend dviscr.
  605.  
  606.  
  607. 2.20:   Why can't I use ESC for quitting dviscr?
  608.  
  609.     ESC is used for leaving the status line when entering a search
  610.     string (for the S command), a page index (G command), a page
  611.     number (P command), scaling factors (Alt+G and Alt+S commands), or
  612.     the transformation (T command).  To avoid quitting dviscr by
  613.     mistake, the key for leaving the status line is different from the
  614.     keys for quitting dviscr.  Use Q or Ctrl+C to quit dviscr.
  615.  
  616.  
  617. dvihplj
  618. -------
  619.  
  620. 2.21:   How can I stop dvihplj from deleting preloaded soft fonts in
  621.         an HP LaserJet?
  622.  
  623.     dvihplj deletes all fonts designated temporary unless
  624.     +delete-fonts:off is used.  You should preload the fonts as
  625.     permanent or use +delete-fonts:off.  You may still get problems
  626.     due to the font numbers assigned to the fonts loaded by the driver
  627.     duplicating those of the soft fonts.  To avoid this use the
  628.     +font-offset option: by setting +font-offset:1000 the driver will
  629.     use 1000 to 1031 for the fonts it downloads.
  630.  
  631.  
  632. 2.22:   Characters go missing at the edges of the page.
  633.  
  634.     Set the correct page size with +page-height and +page-width.  Note
  635.     that laser printers cannot print within about 5mm from any edge of
  636.     the paper.
  637.  
  638.     Some DeskJet models have a switch for selecting the page length.
  639.     Set that switch correctly.  If your DeskJet does not have such a
  640.     switch, use the +paper and +set-paper options.
  641.  
  642.  
  643. 2.23:   My HP LaserJet II produces an interesting, but undesired,
  644.         pattern in the middle of the page.
  645.  
  646.     This sometimes happens when the page height set with +page-height
  647.     is larger than the printer permits.
  648.  
  649.  
  650. 2.24:   How can I include a PCL file (a print file for the LaserJet
  651.         produced by another program) in a TeX document?
  652.  
  653.     Use \special{em:pclfile ...} to include a PCL file; however, that
  654.     works with dvihplj only.
  655.  
  656.     If the file contains only graphics (no text), you can convert it
  657.     into a MSP or PCX file with PCLtoMSP and then include it with
  658.     \special{em:graph}.  This works with all emTeX DVI drivers,
  659.     including dviscr and dvipm.
  660.  
  661.  
  662. 2.25:   dvihplj doesn't work with my HP LaserJet+ compatible printer.
  663.  
  664.     Try the following options: +optimize-graphics:off,
  665.     +negative-top-offset:off, +clear-fonts:1, and
  666.     +full-page-bitmap:on.
  667.  
  668.  
  669. dvidot
  670. ------
  671.  
  672. 2.26    The output has `shadows' or the left margin is jagged.
  673.  
  674.     Create a new DOT file with empty BLANK_WIDTH or switch the printer
  675.     to 10 CPI.  See \emtex\doc\english\makedot.doc for details.
  676.  
  677. 2.27:   Why is the printed output so bad?  Sometimes lines overprint
  678.         one another and at other times characters are cut by this
  679.         horizontal lines.  Sometimes lines are reduced in height.
  680.  
  681.     The fault is usually the printer's.  To print correctly even the
  682.     smallest paper movement must be executed exactly.  You could try
  683.     experimenting with tractor feed and sheet feed.  This problem
  684.     occurs more frequently with printers from some manufacturers than
  685.     others but I am not going to name names.  Remedy: Use 360x180 DPI
  686.     instead of 360x360 DPI.
  687.  
  688.  
  689. 2.28:   How can I make sure that the margin from the perforation is
  690.         correct; I am using fanfold paper?
  691.  
  692.     Always feed an empty sheet through first and adjust the paper so
  693.     that the margin is correct.  The empty first page is necessary as
  694.     many printers cannot start printing right at the top of the first
  695.     page.
  696.  
  697.  
  698. dvipm
  699. -----
  700.  
  701. 2.29:   How can I save the options of dvipm?
  702.  
  703.     Use Options->Save_options to save the options to a file, say,
  704.     \emtex\data\dvipm.cnf.  Use that file as response file on the
  705.     command line of dvipm.exe or load it with Options>-Load_options.
  706.     You can save the other settings (window position etc.) with
  707.     File->Settings->Save.  These will be reloaded automatically.
  708.  
  709.  
  710. 2.30:   How can I print with dvipm?  dvipm says
  711.  
  712.           0x203e - GpiSetBitmap failed.
  713.  
  714.         when printing.
  715.  
  716.     Select File->Print_Options to open the `Print Options' dialog,
  717.     then select `Bitmap' and `Use GpiDrawBits'.
  718.  
  719.  
  720. 2.31:   How can I print with dvipm?  All character codes are shifted: A
  721.         is printed instead of B, etc.
  722.  
  723.     Select File->Print_Options to open the `Print Options' dialog,
  724.     then select `Bitmap'.
  725.  
  726.  
  727. 2.32:   How can I avoid emTeX saying
  728.  
  729.           ! I can't write on file `xxx.dvi'.
  730.  
  731.         when I try to run emTeX while dvipm displays xxx.dvi?
  732.  
  733.     In dvipm, select File->New or File->Auto_reload.
  734.  
  735.  
  736. 2.33:   A dialog box is displayed when I start dvipm:
  737.  
  738.           SYS2070
  739.           The system could not demand load the application's segment.
  740.           DVIPM->EMDLL2X.46 is in error.
  741.  
  742.         What's wrong?
  743.  
  744.     You are using an out-dated version of emdll2x.dll.  Make sure that
  745.     exactly one directory containing emdll2x.dll (c:\emtex\dll) is
  746.     listed in the LIBPATH statement of config.sys.  Make sure that you
  747.     are using the version of emdll2x.dll shipped with dvipm.
  748.  
  749.  
  750. 2.34:   dvipm shows boxes of characters, how can I make it show characters?
  751.  
  752.     Start dvipm by running vp.cmd instead of running dvipm.exe.  If
  753.     you want to create a WorkPlace Shell program object for dvipm,
  754.     type `@p6l' (or a reference to another configuration file) in the
  755.     `Parameters' entryfield.
  756.  
  757.  
  758. 3. METAFONT
  759. ===========
  760.  
  761. 3.1:    Why doesn't METAFONT display a picture on my screen?
  762.  
  763.     METAFONT works only with the following adapters: CGA, EGA and VGA.
  764.     In particular, if you have a Hercules compatible card then you
  765.     will not get any graphic output.  mf386 does not support graphical
  766.     output under DOS.
  767.  
  768.  
  769. 3.2:    emTeX does not have INIMF.  What shall I do?
  770.  
  771.     INIMF is there, simply call METAFONT with `mf /i' (see also
  772.     \emtex\doc\english\metafont.doc).
  773.  
  774.  
  775. 3.3:    METAFONT displays error messages for some fonts or creates
  776.         wrong TFM files.
  777.  
  778.      MF files that don't contain a line similar to
  779.  
  780.        if unknown cmbase: input cmbase fi
  781.  
  782.     should usually be processed with plain.bas, not with cm.bas.
  783.     Examples are the line and lcircle fonts.
  784.  
  785.  
  786. 3.4:    makebas complains about `plain.mf' or `s640x480.mf' not being
  787.         installed.  What's wrong?
  788.  
  789.     As mentioned by INSTALL.ENG, you should unset the MFINPUT
  790.     environment variable.  If you need MFINPUT, don't forget to add
  791.     `!' to the end of the path of emTeX's `mfinput' directory.
  792.  
  793.  
  794. 3.5:    METAFONT says
  795.  
  796.           I can't find the PLAIN base file!
  797.  
  798.         What's wrong?
  799.  
  800.     You forgot to create the base files or METAFONT cannot find the
  801.     base files.  See the installation instructions in
  802.     \emtex\doc\english\metafont.doc.  Usually, you should not set the
  803.     MFBAS and BMFBAS environment variables.
  804.  
  805.  
  806. 3.5:    I call METAFONT with the command line
  807.  
  808.           mf &cm \smode="mymode"; input cmr10
  809.  
  810.         but the quotes disappear.
  811.  
  812.     You should use
  813.  
  814.       mf &cm \smode=\"mymode\"; input cmr10
  815.  
  816.     instead, see \emtex\doc\english\metafont.doc.
  817.  
  818.  
  819. 3.7:    Why does METAFONT not switch back into text mode when it is finished?
  820.  
  821.     That would clear the screen, removing the messages there.  Type
  822.  
  823.       mode co80
  824.  
  825.     to switch back to text mode (type `mode mono' if a monochrome
  826.     adapter is installed).
  827.  
  828.  
  829. 3.8:    Why does METAFONT overwrite the graphics with text?
  830.  
  831.     I was too lazy to put it right, besides it is not easy.  The
  832.     problem has been solved for OS/2.
  833.  
  834.  
  835. 3.9:    METAFONT overwrites the graphics with blanks.
  836.  
  837.     Some versions of ansi.sys (and replacements) seem to cause this
  838.     problem.  Try without ANSI driver.  Try another ANSI driver.
  839.  
  840.  
  841. 3.10:   How can I get rid of the mfj*.tmp subdirectory that MFjob
  842.         sometimes leaves behind ?
  843.  
  844.     Run `emdelete -r mfj*.tmp' in all directories that contains such
  845.     subdirectories.
  846.  
  847.  
  848. 3.11:   METAFONT's version number is 2.718, however plain.mf's version
  849.         number is 2.71. Is there anything wrong?
  850.  
  851.     No.
  852.  
  853.  
  854. 3.12:   METAFONT crashes (I have a rather unusual memory card).
  855.  
  856.     Use the /d option with METAFONT or MFjob.
  857.  
  858.  
  859. 3.13:   GFtoDVI cannot find gray.tfm or slant.tfm or black.tfm.
  860.  
  861.     See \emtex\doc\english\mfware.doc.
  862.  
  863.  
  864. 3.14    When computing a DC font, METAFONT says:
  865.  
  866.           ! Not implemented: (boolean)or(unknown numeric).
  867.  
  868.         What shall I do?
  869.  
  870.     Delete or regenerate the dx.bas base file.
  871.  
  872.  
  873. 3.15:   Has emTeX's METAFONT passed the trap test?
  874.  
  875.     Yes.
  876.  
  877.  
  878. 3.16:   How do I add a new METAFONT mode?
  879.  
  880.     1. Add a `mode_def' for the new mode to \emtex\mfinput\etc\local.mf
  881.  
  882.     2. Add appropriate definitions to \emtex\mfjob\modes.mfj, using
  883.        the existing definitions as models
  884.  
  885.     3. Create a configuration file (CNF file) for the new mode and put
  886.        it into directory \emtex\data
  887.  
  888.     4. Recreate all the base files with makebas
  889.  
  890.  
  891. 4. FONTS
  892. ========
  893.  
  894. 4.1:    What are FLI files (files with extension .fli)?
  895.  
  896.     These are "font libraries".  A single file contains several font
  897.     files (PK or PXL).  Further information can be found in
  898.     fontlib.doc and dvidrv.doc (+font-libraries).
  899.  
  900.  
  901. 4.2:   I have other printer drivers which cannot use font libraries;
  902.        does this mean that I have to keep both the font library and
  903.        the font files on the disk?
  904.  
  905.     No.  The files in the font library can be unpacked with fontlib,
  906.     that is, split up into single files again.  The dvidrv printer
  907.     drivers work both with font libraries and with single files.
  908.     After unpacking, the font libraries are no longer needed.  The
  909.     font library file does, however, make a good backup as backing up
  910.     many small files is inefficient.  See fontlib.doc and dvidrv.doc
  911.     (+font-files).
  912.  
  913.  
  914. 4.3:    What is the difference between "cmr10 scaled 1200" (that is,
  915.         "cmr10 at 12pt" and "cmr12"?  Removing duplicate fonts would
  916.         save quite a bit of space on the disk!
  917.  
  918.     The answer is given in The TeXbook, page 16.  Each font is
  919.     designed for a particular size, magnified fonts are just that,
  920.     magnified: the stroke widths, height, width and spacing must be
  921.     changed for the new size, they are not simply in proportion.
  922.     Using a magnified font is a last resort for use when the correct
  923.     font is not available -- unless, of course, the page is to be
  924.     reduced after printing.  There are parameter files (from John
  925.     Sauter) to generate Computer Modern fonts in unusual sizes (other
  926.     than 5, 6, 7, 8, 9, 10, 12, 17pt) but these are not yet in general
  927.     use.  The DC font use a similar scheme.
  928.  
  929.  
  930. 4.4:    I already have a set of TeX fonts, do I need the FLI files
  931.         mentioned in INSTALL.ENG, QUICK.ENG, README.ENG, and
  932.         dvidrv.doc?
  933.  
  934.     You can use your fonts as long as they are PK files (with ID 89)
  935.     or PXL files (with ID 1001 or 1002).  Fonts in GF format cannot be
  936.     used (GFtoPK.exe will convert them).  Note, however, that the
  937.     sources for the Computer Modern fonts have changed in 1992 and
  938.     1995; you should no longer use the old fonts.  The TFM files have
  939.     not changed.
  940.  
  941.  
  942. 4.5:    I would like to generate the fonts myself, how do I do this?
  943.  
  944.     INSTALL.ENG tells you how to create the base font library files.
  945.     See also the documentation for MFjob (mfjob.doc).  It is not
  946.     recommended to run MFjob on all.mfj, that's overkill.  The DVI
  947.     drivers automatically call MFjob to generate missing fonts.
  948.  
  949.  
  950. 4.6:    Why can't GF files be used?
  951.  
  952.     GF files use a great deal of disk space and the routines to read
  953.     GF files would make the DVI drivers even larger.  Apart from this,
  954.     GF files can easily be converted into PK files.  For these reasons
  955.     I have decided not to support GF files in the drivers.
  956.  
  957.  
  958. 4.7:    I would like to print using 180 DPI fonts for draft as well as
  959.         360 DPI fonts for final copy but I haven't enough room on my
  960.         disk for both the P6L and the P6H fonts.
  961.  
  962.     The drivers can reduce the size of the fonts they use.  For
  963.     instance, you can have the P6H fonts on your disk which the driver
  964.     can scale down to 180 DPI -- though the result is not as good as
  965.     using the P6L fonts.  Fonts can be scaled by the factors 1, 2, 3,
  966.     4, 5, 6, 7 and 8 --- fractional values are not possible.  You can,
  967.     however, have different horizontal and vertical factors.
  968.  
  969.  
  970. 4.8:    What is a virtual font?
  971.  
  972.     While we used Computer Modern fonts and 7-bit characters,
  973.     everything was simple.  But increasingly, built-in font sets
  974.     (PostScript!) were being used too.  This caused difficulties when
  975.     a document was to be previewed on the screen, or printed on a
  976.     device which did not contain these fonts.  Virtual fonts come to
  977.     the rescue here: they consist of a TFM file (which contains
  978.     information on ligatures and character widths) and a VF file.  The
  979.     VF file tells the printer driver how the different characters of
  980.     the font are to be generated.  For instance, whether the
  981.     characters can be replaced by another font (e.g. cm font) or made
  982.     up from two other characters.  If we have an 8-bit virtual font in
  983.     which the characters from 0 to 127 correspond to a cm font and the
  984.     rest are accented characters, then the VF information for these
  985.     accented characters can show that they are to be made from
  986.     existing ones, for instance, letter and accent.
  987.  
  988.  
  989. 4.9:    How can I fix wrong character spacing?
  990.  
  991.     The fonts must match the TFM files used for typesetting the
  992.     document.  Perhaps you got hit by a bug in emTeX's printer drivers
  993.     which strikes when substituting a font with one of a different
  994.     design size.  Until this bug is fixed, don't substitute fonts with
  995.     fonts of a different design size.
  996.  
  997.  
  998. 4.10:   The drivers cannot find the fonts circle10 and circlew10.
  999.         What can I do?
  1000.  
  1001.     The fonts containing circles, quarter circles, and discs have been
  1002.     renamed from circle* to lcircle*.  You can make the emTeX DVI
  1003.     drivers change the names (circle* -> lcircle*) using the font
  1004.     substitution file circle.sub: +font-subst-file:circle.
  1005.  
  1006.  
  1007. 4.11:   What's the `Cork Encoding'?
  1008.  
  1009.     The Computer Modern fonts employ a 7-bit encoding, allowing for
  1010.     128 different characters.  In 1990, at the TeX User's Group
  1011.     meeting in Cork, Ireland, an 8-bit encoding was created (allowing
  1012.     for 256 different characters).  That encoding is called the `Cork
  1013.     Encoding'.  For instance, the DC fonts use the Cork Encoding.
  1014.  
  1015.  
  1016. 4.12:   Where can I find xx_more.fli?
  1017.  
  1018.     Those font libraries are intended for local fonts.  See
  1019.     INSTALL.ENG on how to create them.
  1020.  
  1021.  
  1022. 5. Miscellaneous topics
  1023. =======================
  1024.  
  1025. 5.1:    A program complains about not being able to create a temporary
  1026.         file.  What's wrong?
  1027.  
  1028.     The environment variable TMP should point to an existing, writable
  1029.     directory.  Note that writing to the root directory of network
  1030.     drives is usually not permitted.
  1031.  
  1032.  
  1033. 5.2:    Will emTeX use a coprocessor if present?  If not, would it run
  1034.         faster with coprocessor support?
  1035.  
  1036.     No.  No.
  1037.  
  1038.  
  1039. 5.3:    I have only a 360 KB (or 720 KB) drive in my machine, how can
  1040.         I get emTeX on suitable disks?
  1041.  
  1042.     Use ZIPSPLIT or SLICE to split the ZIP files.  Or use BACKUP to
  1043.     make 360 KB diskettes.
  1044.  
  1045.  
  1046. 5.4:    The emTeX documentation is rubbish, I can write better!
  1047.  
  1048.     Please do so and then send it to me so I can include it with
  1049.     emTeX.
  1050.  
  1051.  
  1052. 5.5:    Where can I find an exact description of VFtoVP, VPtoVF,
  1053.         TFtoPL and PLtoTF?
  1054.  
  1055.     You can find the description in the files vftovp.web, vptovf.web,
  1056.     tftopl.web and pltotf.web, which are not included with emTeX.
  1057.  
  1058.  
  1059. 5.6:    Where can I find a description of PiCTeX?
  1060.  
  1061.     You will find the answer in \emtex\doc\english\install.eng.
  1062.  
  1063.  
  1064. 5.7:    Is there an emTeX version for Linux, Macintosh, Windows NT,
  1065.         Unix, ...?
  1066.  
  1067.     No.  emTeX is available for OS/2, MS-DOS, and PC-DOS.  There are
  1068.     other ports of TeX for other machines and operating systems.
  1069.  
  1070.  
  1071. 5.8:    Will there be emTeX etc. for other operating systems?
  1072.  
  1073.     No, that's not planned.
  1074.  
  1075.  
  1076. 5.9:    What is CTAN?
  1077.  
  1078.     CTAN means Comprehensive TeX Archive Network, a collective term
  1079.     for certain ftp servers using the same directory structure and
  1080.     mirroring each other.  Please use the host closest to you:
  1081.  
  1082.       ftp.shsu.edu    (USA)
  1083.       ftp.dante.de    (Germany)
  1084.       ftp.tex.ac.uk   (UK)
  1085.  
  1086.     There are a lot of partial and complete mirrors of CTAN.
  1087.  
  1088.  
  1089. 5.10:   Where's the book list?  There used to be one in the README.ENG
  1090.         file of previous emTeX releases.
  1091.  
  1092.     It has been removed because there are too many books available.
  1093.     Any selection of books would be incomplete, biased, out-dated, and
  1094.     unqualified (because I haven't read all the books).
  1095.  
  1096.  
  1097. 5.11:   Are there any user interfaces (shells) for emTeX?
  1098.  
  1099.     There are too many to be listed here. Most of them are available
  1100.     from CTAN.  Let me give just four examples:
  1101.  
  1102.       J\"urgen Schlegelmilch's TeXShell (DOS, text mode)
  1103.       CTAN: /tex-archive/systems/msdos/texshell/ts271.zip
  1104.  
  1105.       Andreas Krebs' TeXtelmExtel (Windows)
  1106.       CTAN: /tex-archive/systems/msdos/emtex-contrib/TeXtelmExtel/...
  1107.  
  1108.       Jon Hacker's EPMTeX (enhancements for OS/2's EPM editor)
  1109.       CTAN: /tex-archive/systems/os2/epmtex/...
  1110.  
  1111.       Kresten Krab Thorup's and Per Abrahamsen's AUC TeX (for GNU Emacs)
  1112.       CTAN: /tex-archive/support/auctex/...
  1113.  
  1114.  
  1115. 5.12:   Is there an installation program for emTeX?
  1116.  
  1117.     An installation program is being worked on.  However, I considered
  1118.     releasing a new emTeX distribution more important than completing
  1119.     the installation program.
  1120.  
  1121.  
  1122.                   -------- End of HELP.ENG -------------
  1123.