home *** CD-ROM | disk | FTP | other *** search
/ MS DOS Archives 1 / MS-DOS_Archives_Volume_One_Walnut_Creek.iso / msdos / tex / dostex1.arc / READ.ME < prev    next >
Text File  |  1988-10-03  |  10KB  |  237 lines
  1.               DosTeX version 2.93a Release Notes
  2.  
  3.                (c) Electronetics, Incorporated
  4.  
  5.                       September 15, 1988
  6.  
  7.  
  8. NEW FEATURES
  9.  
  10. DosTeX version 2.93a corresponds to TeX version 2.93, currently the
  11. latest revision from Don Knuth.  This version contains support for
  12. run-time sizing of the mem[] array within INITEX.  In addition, a
  13. utility is provided to allow construction of preloaded versions from
  14. INITEX dumps.  Preloaded versions are therefore no longer distributed.
  15. Instead, example .BAT files are provided which may be used to produce 
  16. preloaded versions of "plain" and LaTeX.  A bug related to invisible
  17. rules has been fixed as well as all previously reported bugs.
  18.  
  19. The Epson printer driver (based on Nelson Beebe's version 2.10) no longer 
  20. swaps the bitmap to disk.  Instead, two passes are made over each page
  21. with a half-size bitmap.  This gives approximately double the performance
  22. of swapping. The bug related to closing log files is fixed.
  23.  
  24. The Hercules previewer is no longer distributed with screen resolution 
  25. (120 dpi) fonts. The default is now to subsample the Epson (240 dpi)
  26. .pk fonts.  Screen resolution fonts may still be selected, but the user
  27. must provide these.
  28.  
  29.  
  30. INSTALLATION PROCEDURE
  31.  
  32. Successful installation of DosTeX requires at least
  33. 4,500,000 bytes of free space on the default drive.
  34. Operation of the DosTeX software requires over 500,000 bytes
  35. of free memory to be accessible.  The exact amount depends on
  36. how much memory is set aside for the mem[] array.
  37. An automatic installation procedure
  38. is provided with DosTeX.  To use it: 
  39.  
  40. 1. Make backup copies of the distribution diskettes to
  41. use in installing DosTeX.  The distribution consists of
  42. six 5.25" diskettes (360k).
  43.  
  44. 2. Create an empty directory in which all DosTeX files
  45. and subdirectories will be created (e.g., MKDIR \TEX).
  46.    
  47. 3. CD to this directory (e.g., CD \TEX).
  48.  
  49. 4. Insert distribution diskette #1 in drive A: and 
  50. give the command A:INSTALL.
  51.  
  52.  
  53. You will be prompted to insert the remaining diskettes as needed.  
  54. Subdirectories INPUTS and FONTS will be created to contain
  55. TeX input files, font metric and raster information.
  56.  
  57. Several environment variables must be set for proper operation of
  58. the DosTeX package. For example, environment variables 
  59. TEXINPUTS and TEXFONTS should be set to the paths containing TeX 
  60. system input files and .tfm information, respectively.  The variable
  61. TEXMEM is used to override the default size for mem[].
  62.  
  63. The installation procedure attempts to append some of this
  64. information to the file \autoexec.bat on the default drive. Assuming
  65. \autoexec.bat is not write-protected, it should suffice to
  66. re-execute \autoexec.bat to set the environment properly.
  67. Otherwise, the variables will have to be set manually. 
  68.  
  69. Following installation, read the general information in GENERAL.DOC
  70. and the redistribution policy in COPYING.DOC.
  71.  
  72. To produce correct TeX results, the last line of each file processed must
  73. end with a carriage return.  Everything following the final carriage return
  74. in a file may be ignored by DosTeX.
  75.  
  76. LIMITATIONS
  77.  
  78. Preloaded versions are not distributed with DosTeX anymore.  The INITEX.EXE
  79. executable swaps both mem[] and font_info[].  The default size for mem[]
  80. is 65530 words.  The font_info[] array is fixed at 21000 words.
  81. Sizes of all other arrays are as given in the WEB source 
  82. of TeX: The Program. A disk file VM.TMP is used to hold the 
  83. swapped-out pages.  At least 512k free disk space must be available for VM.TMP.
  84. If the environment variable TMP exists, it will be used as the
  85. directory for the VM.TMP file (hopefully, a RAMdisk).
  86. Otherwise, the default directory will be used. A typical
  87. setting would be set TMP=E:\ to use E:\VM.TMP as the swap space.
  88.  
  89. INITEX will dump and read .FMT (format) files. Pre-loaded versions do 
  90. not read any format files.
  91.  
  92. There is no check in any of the versions for a disk-full condition.
  93. Symptoms of this may include truncated .dvi and other output files.
  94.  
  95. CREATING A PRELOADED TEX
  96.  
  97. VIRTEX and preloaded versions are no longer distributed.  Instead, preloaded
  98. versions may be produced using PRELOAD.EXE.  Since none of the DosTeX utilities
  99. check for a disk-full condition, the user must monitor disk space closely 
  100. during the following steps.
  101.  
  102. First, decide how much memory
  103. to allocate to mem[].  The .BAT files supplied with DosTeX use a size of 30000
  104. words.  The default size is 65530, which will almost certainly be too large,
  105. since the preloaded version will not swap the array.  Set the TEXMEM 
  106. environment variable accordingly.  For example,
  107.  
  108. SET TEXMEM=30000
  109.  
  110. indicates that 30000 words are to be reserved for mem[].  
  111.  
  112. Second, run INITEX.
  113. You may wish to use the TMP variable to force swapping to a RAMdisk, although
  114. this is not absolutely necessary.  The dump command will cause INITEX to write
  115. two files to the current directory.  One is the .fmt file, which may be read
  116. again (by INITEX) with the "&" notation.  The second is a file named IMAGE.MEM.
  117. This contains the array contents to use for preloading.
  118.  
  119. Third, run PRELOAD.EXE.  PRELOAD requires that IMAGE.MEM be present.  It also
  120. requires source and destination filenames.  The source should always be the
  121. file PRELOAD.PRE, supplied with the distribution.  This is the template from
  122. which all preloaded versions are built.  The destination is the name of the
  123. preloaded .EXE file.  NOTE: To run any preloaded TeX under versions of DOS
  124. prior to DOS 3.0, an additional environment variable named TEXEXE must be set.
  125. It should be set to the full pathname of the preloaded executable.
  126. Example: SET TEXEXE = C:\TEX\LATEX.EXE
  127.  
  128. Example scripts for producing preloaded versions of "plain" and LaTeX are
  129. provided in PLAIN.BAT and LATEX.BAT.  The memory allocated for mem[] should
  130. be modified as needed in the local installation environment.
  131.  
  132. SUPPORT POLICY
  133.  
  134. There is no warranty of any kind for DosTeX. Don Knuth of Stanford
  135. University is the original author of the TeX system. DosTeX is
  136. simply a port of his work to the MSDOS operating system. In the
  137. WEB source of TeX Knuth writes,
  138.  
  139.         Although considerable effort has been expended to make
  140.         the TeX program correct and reliable, no warranty is
  141.         implied; the author disclaims any obligation or liability
  142.         for damages, including but not limited to special, 
  143.         indirect, or consequential damages arising out of or in
  144.         connection with the use or performance of this software.
  145.  
  146. This disclaimer applies equally to DosTeX.  Nevertheless, it is
  147. the intent of Electronetics, Inc. to continue to update DosTeX
  148. as new versions of TeX become available and to correct bugs
  149. which may have been introduced by the porting process.  This version
  150. of DosTeX has passed the TRIP validation test specified
  151. by Knuth.  
  152.  
  153. Support of DosTeX at present consists of correction of bugs
  154. reported to and verified by Electronetics, Incorporated.
  155. It is currently provided at no charge. Anything that prevents
  156. or hinders the proper operation of producing documents using DosTeX
  157. consitutes a potential bug. If applicable, a DosTeX bug should
  158. exhibit behavior not shown by other versions of TeX.
  159.  
  160. Bug reports must contain sufficient information to reliably reproduce the
  161. aberrant behavior. Other pertinent information such as your name and address
  162. must be included.  Telephone support is not available at present.
  163. Suggested fixes or workarounds are welcome. Enhancements to DosTeX 
  164. or requests for other TeXware will be handled on an individual basis.  
  165.  
  166.  
  167. Send bug reports and other correspondence to: 
  168.  
  169.                 Gary Beihl
  170.                 Electronetics, Incorporated
  171.                 Paine Field, Bldg. 335
  172.                 Everett, WA 98204   USA
  173.  
  174. The current distribution may be ordered from the above address by
  175. sending (check or money order to Electronetics) for US$75
  176. (US$85 foreign).
  177.  
  178. HINTS
  179.  
  180. The DosTeX preloaded versions require access to over 500,000 bytes free memory. 
  181. The amount of free memory may be checked using the CHKDSK command under DOS.
  182. If you experience difficulty finding enough free memory, the
  183. following hints may be useful.  Reboot after any changes to CONFIG.SYS,
  184. then rerun CHKDSK.
  185.  
  186. 1. Try making a preloaded version with a smaller value for TEXMEM.
  187.  
  188. 2. If you have a CONFIG.SYS file, remove all device driver 
  189. entries from it. These are lines beginning with `DEVICE = ...'.
  190. If your device drivers are small, you may be able to squeeze them back in.
  191. We have run DosTeX with drivers for a RAMdisk and a harddisk present
  192. (DOS 3.1). Buffers also occupy substantial memory.  For example,
  193. changing `BUFFERS=20' to `BUFFERS=10' will save over 5000 bytes.
  194. If you have difficulty opening files for no apparent reason, try adding
  195. `FILES=10' (or larger) to your CONFIG.SYS file.
  196.  
  197. 3. Remove any memory-resident (`pop-up') utilities. Note that
  198. PRINT.COM leaves behind a resident portion after the first execution.
  199. Try `COPY /B A.FILE PRN' instead of `PRINT A.FILE'.
  200.  
  201. 4. The environment also occupies space.  This is the /E:nn option in
  202. the `SHELL=...' line of CONFIG.SYS, where nn is the
  203. number of 16-byte paragraphs reserved for the environment (DOS 3.1). 
  204.  
  205. The environment variables TEXINPUTS and TEXFONTS tell DosTeX
  206. where system input and .tfm files are located. TEXFORMATS tells where
  207. to look for .fmt (format) files. You won't need TEXFORMATS unless you
  208. use INITEX. Example settings are
  209.  
  210. SET TEXINPUTS=C:\TEX\INPUTS
  211. SET TEXFONTS=C:\TEX\FONTS\TFM
  212. SET TEXFORMATS=C:\TEX\FORMATS
  213.  
  214. The environment variable FONTDIR tells the Epson .dvi driver (DVIEPS) and
  215. Hercules previewer (DVI2HERC) where
  216. to find the font raster images. They assume subdirectories for each 
  217. magnification.  For example, with
  218.  
  219. SET FONTDIR=C:\TEX\FONTS\PK\
  220.  
  221. DVIEPS will look for \magstep0 font cmr10 (PK format) in file
  222.  
  223. C:\TEX\FONTS\PK\240\CMR10.PK
  224.  
  225. since the Epson is a 240 dots per inch
  226. device (horizontal).
  227.  
  228. The 4,500,000 byte disk space requirement is only approximate.  Should you
  229. experience unexplained difficulty in installation or production of preloaded
  230. versions, you may need to free up more disk.
  231.  
  232.  
  233. 
  234.  
  235.  
  236.  
  237.