home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / TEKST / DVIPS554 / LEESMIJ.TXT < prev   
Text File  |  1994-03-06  |  7KB  |  153 lines
  1. Some notes on installing dvips 5.5 on MS-DOS and OS/2
  2. by Russell Lang  <rjl@monu1.cc.monash.edu.au>  17th February 1994
  3.  
  4. These notes are not by Tomas Rokicki.  
  5. Tomas Rokicki does not use MS-DOS ( smart person :-) and so will be 
  6. unable to answer questions about MS-DOS problems.
  7.  
  8. =========
  9. ZIP files
  10. =========
  11. If you have ZIP files, one should contain the sources of dvips
  12. (same as labrea.stanford.edu:pub/dvips55?.tar.Z) and the other
  13. should contain dvips ready to run with the following compiled 
  14. versions of dvips:
  15.    dvips.exe          MS-DOS 8086
  16.    dvipswin.exe       MS-Windows 3.1
  17.    dvips32.exe        OS/2 32 bit or MS-DOS with EMX DOS extender
  18. The following may or may not be in the ZIP file.
  19.    dvips16.exe        OS/2 16 bit and MS-DOS (MSC6).
  20.  
  21. To install this in the emTeX directories on drive C:, use 
  22.         unzip dvips55? c:\
  23.  
  24. =======
  25. General
  26. =======
  27. If you want to use a different directory arrangement, modify the
  28. paths in c:\emtex\ps\config.ps.  If you want to store config.ps or 
  29. psfonts.map in a different place, either recompile dvips or use the 
  30. environment variable TEXCONFIG.
  31.  
  32. The LaTeX and TeX input files supplied with dvips (e.g. epsf.sty, epsf.tex)
  33. are now put in c:\emtex\texinput\dvips and not in their old location
  34. c:\emtex\texinput.  This means that you need emTeX beta 11 and you will 
  35. need to enable emTeX's subdirectory searching with
  36. set TEXINPUT=c:\emtex\texinput!
  37.  
  38. The MSDOS and OS/2 versions of dvips differ from the Unix version
  39. described in dvips.tex in the following ways:
  40. - path separators are ';' not ':'
  41. - directory separators are '\' not '/'
  42. - The user's initialization file is "dvips.ini" not ".dvipsrc".
  43. - Printer configuration files are called <printer-name>.cfg,
  44.   not config.<printer-name>.
  45. - Pipes to printers are not supported by MS-DOS.  Output must go to a file.
  46.   OS/2 supports pipes.
  47. - MakeTeXPk is a batch or command file.
  48.   Since MS-DOS has insufficient memory to run both dvips and metafont 
  49.   at the same time, this batch or command file will typically write out 
  50.   a set of commands for running metafont later.  
  51.   The maketexp.bat supplied writes out an mfjob file for em\TeX.
  52.   OS/2 has more memory so the maketexp.cmd supplied writes out an 
  53.   mfjob file for emTeX and calls mfjob.
  54.   The emTeX betatest mfjob 1.1l package is required.
  55. - To automatically make fonts under MS-DOS, use emTeX's dvidrv as follows:
  56.     dvidrv dvips file.dvi
  57.   dvidrv is part of the emTeX betatest dvidrv 1.4s package.
  58.   dvidrv sets an option -pj=mfjobfile for dvips, where mfjobfile
  59.   is the name of a temporary mfjob file.
  60.   If there are missing fonts, dvips will write this mfjob file
  61.   and then ask:
  62.     Exit to make missing fonts now (y/n)?
  63.   If you answer yes, dvips exits with errorlevel 8 which tells 
  64.   dvidrv to call mfjob to make the fonts, and then to call dvips again.
  65.   For this to work, dvidrv, dvips, mfjob and mf must be located in
  66.   the PATH, and the environment variables for mfjob and mf set
  67.   correctly.  A font mode must be set with the 'M' option in config.ps.
  68.   If the -pj option is set, dvips will not call MakeTeXPk.bat
  69. - limited emTeX specials.  The following ones are supported:
  70.   \special{em:message xxx}
  71.   \special{em:point n}
  72.   \special{em:line a[h|v|p],b[h|v|p] [,width]}
  73.   \special{em:linewidth width}
  74.   \special{em:moveto}
  75.   \special{em:lineto}
  76.   \special{em:graph xxx[,width[,height]]}
  77.   The line cut parameters [h|v|p] of the \special{em:line ...} command 
  78.   are ignored.  Lines are ended with a rounded cap.
  79.   A maximum of 1613 different point numbers are permitted on each page.
  80.   The \special{em:graph xxx} should work with PCX, MSP1, MSP2 and
  81.   BMP files.  Compressed BMP files have not been tested.
  82.   The graph file may be scaled by giving an optional width and 
  83.   height (expressed in the same way as TeX dimensions).
  84.   An example: \special{em:graph scrdump.pcx,100mm,75mm}
  85.  
  86. The program dvips can use emTeX font libraries created with the 
  87. fontlib /2 option.  PXL fonts within font libraries will be ignored.
  88.  
  89. If you run out of memory running dvips, try using the `-Z0 -a' or
  90. just the `-a' command line options.  If that fails, use the 32 bit
  91. version.
  92.  
  93. =====
  94. Files
  95. =====
  96. This set of MSDOS and OS/2 files for dvips contains:
  97. README.pc     This file.
  98. makefile.tc   Makefile for Borland C++ (MS-DOS).
  99. makefile.emx  Makefile for nmake/ndmake and emx/gcc (OS/2 and MS-DOS).
  100. makefile.msc  Makefile for dmake and MSC6 (OS/2).
  101. makefile.wat  Makefile for Watcom C (untested)
  102. makefile.wt2  Makefile for Watcom C (untested)
  103. config.ps     config.ps modified for MSDOS and OS/2
  104. maketexp.bat  Batch file to make tex pk files.
  105. maketexp.cmd  OS/2 batch file to make tex pk files.
  106. winmain.c     WinMain() routine for Windows dvips.
  107. dvipswin.rc   Windows Resource file containing radical eye icon.
  108. dvipswin.def  Windows defaults file.
  109. afm2tfm.def   OS/2 16 bit defaults file.
  110. dvips16.def   OS/2 16 bit defaults file.
  111. squeeze.def   OS/2 16 bit defaults file.
  112.  
  113. =========
  114. Compiling
  115. =========
  116. If you have the Unix tar file, the steps involved in making 
  117. dvips on a PC are:
  118. -  On Unix, in the dvips directory, give the following commands:
  119.       make texc.lpro
  120.       nroff -man dvips.1 > pc/dvips.doc
  121.       nroff -man afm2tfm.1 > pc/afm2tfm.doc
  122. -  Copy dvips/* and dvips/pc/* directories to the PC.
  123. -  copy PStfms/*.tfm to C:\EMTEX\TFM on the PC 
  124.    (then optionally delete pst*.tfm, rpst*.tfm, pop*.tfm rpop*.tfm,
  125.     pad*.tfm rpad*.tfm)
  126. -  copy PSvfs/*.vf to C:\TEXFONTS\VF on the PC
  127.    (then optionally delete pst*.vf, pop*.vf, pad*.vf)
  128. -  edit dvipsmac.tex and replace the line
  129.       \generictrue
  130.    with
  131.       %\generictrue
  132.  
  133. For Borland C++:
  134. -  edit paths and directories in pc/makefile.tc and pc/config.ps.
  135. -  'make -fpc/makefile.tc'
  136.    Borland C++ gives a large number of 'possible incorrect assignment'
  137.    warnings.  
  138. -  if that works, try 'make -fpc/makefile.tc install'.
  139. -  change to another directory (to avoid using the Unix config.ps)
  140.    and then try to run dvips!
  141.  
  142. For emx/gcc:
  143. -  edit paths and directories in pc/makefile.emx and pc/config.ps.
  144. -  If using HPFS, type 'nmake -fpc\makefile.emx fixup'
  145. -  If using ndmake under msdos, PKPATH will need to be changed to
  146.    using single % not %%.
  147. -  'nmake -f pc\makefile.emx'
  148. -  if that works, try 'nmake -f pc\makefile.emx install'.
  149. -  change to another directory (to avoid using the Unix config.ps)
  150.    and then try to run dvips32!
  151. -  dvips32.exe will run under OS/2 and MSDOS.
  152. -  See the EMX documentation for the EMX DOS extender.
  153.