home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / dvips583.zip / README.EMX < prev   
Text File  |  1998-11-19  |  10KB  |  253 lines
  1. /*--------------------------------------------------------------------------*/
  2.     README.EMX (OS/2 and DOS)                    November 19, 1998
  3. /*--------------------------------------------------------------------------*/
  4.  
  5. This is dvips 5.83 that was compiled with emx/gcc 0.9c fix04 under OS/2 Warp
  6. 3.0.  For dvips usage, read the dvips user's manual (emtex\doc\dvips\dvips.ps).
  7.  
  8. The dvips 5.83 sources were patched for emTeX, based on Guido Sawade's patches
  9. to dvips 5.58.    Minor changes and bug fixes were also made in addition to the
  10. old patches.  All compliments for emTeX patches should go to Guido Sawade.
  11.  
  12. Included executables are OS/2+DOS bound executable, so they will also work
  13. under DOS (VCPI) via EMX runtime library, as well as under Windows (DPMI) with
  14. a RSX runtime libarary.
  15.  
  16. Under Windows 95/98, the long file names should be supported with RSX runtime
  17. library.  The special option -RO (to emulate OS/2) is not required for this.
  18.  
  19. If you have installed the latest emTeX distribution, you already have both EMX
  20. and RSX runtime libraries installed on your system.  (They are in emxrsx.zip
  21. in emTeX distribution.)  Win95/98 or NT users may want RSXNT runtime package.
  22. EMX or RSX/RSXNT runtime libraries are available from CTAN sites.
  23.  
  24. EMX:
  25.     emxrt.zip    -- for DOS (VCPI) and OS/2
  26.     (ftp://hobbes.nmsu.edu/pub/os2/dev/emx/v0.9c/emxrt.zip is the latest.)
  27.  
  28. RSX:
  29.     rsx*.zip    -- for DOS (DPMI) (DOS box under Windows)
  30.     rsxwin*.zip -- for DOS and Windows 3.1
  31.     rsxn*r.zip    -- RSXNT runtime package for Win95/98 or NT
  32.  
  33.     Home: http://www.mathematik.uni-bielefeld.de/~rainer/
  34.       ftp://ftp.uni-bielefeld.de/pub/systems/msdos/misc/
  35.  
  36. This archive dvips583.zip contains the following files:
  37.  
  38.     README.EMX            -- This file
  39.     dvipsexe.zip (required) -- OS/2+DOS bound executables + support files
  40.     contrib.zip  (optional) -- miscellaneous macros & support files for dvips
  41.     patsrc.zip     (optional) -- Patched source files for emTeX and emx/gcc
  42.  
  43.  
  44. INSTALLATION:
  45. ------------
  46.  
  47. (1) If you are the first user of dvips, go to step (2).
  48.  
  49.     You may want to save your old configuration files in emtex\data\dvips\
  50.     before unpacking.  Then, remove old dvips files from your system by using
  51.     emremove.exe and emtex\remove\dvips*.rem files.  An example would be:
  52.  
  53.     D:\> emremove emtex\remove\dvips572.rem D:\
  54.  
  55. (2) Unpack dvipsexe.zip in the parent (usually a root) dir of emTeX tree.
  56.     For example, if you have emtex in D:\emtex, then goto D:\ and unzip by
  57.  
  58.     D:\> unzip dvipsexe.zip
  59.  
  60.     I recommend you to use Info-Zip's unzip.  If you are prompted with a
  61.     question of "Overwrite?", answer 'A'll.
  62.  
  63. (3) You need to update emtex\data\config.ps file for your system.
  64.     If you have used a previous version of dvips, the old config.ps may work.
  65.     Now dvips should work if your emTeX was configured in a standard way.
  66.     For further information about configurations, refer to other documents that
  67.     you can find in emtex\doc\dvips\ and emtex\doc\dvips\old\ (still useful).
  68.  
  69. (4) For automatic font generations, modify maketexp.{cmd|bat} according to
  70.     the commented instrucions near the end of the batch files.
  71.  
  72.  
  73. NOTE 1:  [Distributed executables]
  74.     dvipsexe.zip will unpack dvips32.exe and dvihps32.exe into emtex\bin.
  75.     These files are
  76.  
  77.     dvips32.exe    -- the regular dvips program without HyperPS feature
  78.     dvihps32.exe    -- the same but with an additional capability of
  79.                Hyperdvi to HyperPostScript
  80.  
  81.     dvihps32.exe provides one more option (-z) for Hyperdvi to HyperPostScript,
  82.     otherwise it should give the same output as dvips32.exe.  You may rename
  83.     either one to dvips.exe.  If you don't use HyperTeX, then use dvips32.exe.
  84.  
  85. NOTE 2:  [OS/2 -- Supporting compressed/gzipped postscript files]
  86.     This version supports gzipped EPS files (*.eps.gz) if they are on an
  87.     OS/2 HPFS partition.  FAT partitions (of DOS or OS/2) are not supported.
  88.     The EPS files (*.eps.Z) created by old unix "compress" should be supported
  89.     as well.  (Extensions of *.ps.gz and *.ps.Z are all supported.)
  90.  
  91.     An OS/2 REXX script "psgzip.cmd" is provided to create *.eps.gz and
  92.     *.eps.bb (BoundingBox) files to be used with LaTeX2e graphics package.
  93.     (.bb files are necessary if figure sizes were not given in .tex document.)
  94.  
  95.     For latex graphics package, add the following line in graphics.cfg:
  96.  
  97.     \ExecuteOptions{dvips}
  98.  
  99.     And, in "dvips.def" file of graphics package, you may want to change:
  100.  
  101.     \@namedef{Gin@rule@.eps.Z}#1{{eps}{.eps.bb}{`gunzip -c #1}}
  102.     \@namedef{Gin@rule@.ps.Z}#1{{eps}{.ps.bb}{`gunzip -c #1}}
  103.     \@namedef{Gin@rule@.ps.gz}#1{{eps}{.ps.bb}{`gunzip -c #1}}
  104.     \@namedef{Gin@rule@.eps.gz}#1{{eps}{.eps.bb}{`gunzip -c #1}}
  105.  
  106.     to:
  107.  
  108.     \@namedef{Gin@rule@.eps.Z}#1{{eps}{.eps.bb}{#1}}
  109.     \@namedef{Gin@rule@.ps.Z}#1{{eps}{.ps.bb}{#1}}
  110.     \@namedef{Gin@rule@.ps.gz}#1{{eps}{.ps.bb}{#1}}
  111.     \@namedef{Gin@rule@.eps.gz}#1{{eps}{.eps.bb}{#1}}
  112.  
  113.     for dvips to _search_ and uncompress the compressed ps file.  Otherwise,
  114.     you have to put an explicit path info of a compressed ps file in latex
  115.     document unless the file is in the current dir.
  116.  
  117. NOTE 3:  [DOS (VCPI) -- If automatic font generation fails under DOS]
  118.     DOS users who use emx runtime module may need to set -p emx option.
  119.     Otherwise, automatic font generation by dvips may fail due to not enough
  120.     DOS conventional free memory.  RSX runtime modules (i.e.  DOS boxes of
  121.     Win3.x/95/98/NT) don't need this setting.  If you run dvips via emTeX's
  122.     dvidrv (by "dvidrv dvips ..."), you may not need -p emx option.  If you
  123.     directly run dvips without using dvidrv, and if you have a problem with
  124.     automatic font generation by dvips (when maketexp bat is configured to run
  125.     mfjob), set EMXOPT environmental variable by
  126.  
  127.     set EMXOPT=-p
  128.  
  129.     in your autoexec.bat.
  130.  
  131. NOTE 4:  [OS/2 & DOS/Win -- Saving dvips screen messages to a file]
  132.     Under OS/2 CMD shell, dvips screen messages can be redirected to a file by
  133.  
  134.     dvips file.dvi > error.msg 2>&1
  135.  
  136.     If your command shell doesn't support stderr redirection, EMX or RSX users
  137.     under DOS or Windows* can use -e option of EMX or RSX to redirect stderr to
  138.     stdout, and then redirect stdout to a file.  For example,
  139.  
  140.     emx -e dvips file.dvi > error.msg
  141.     rsx -e dvips file.dvi > error.msg
  142.  
  143.     Alternatively, all messages from dvips can be saved to a file by setting
  144.     DVIPS_STDERR environmental variable.  (Do we really need this feature??)
  145.     For this, the environmental variable DVIPS_STDERR should be set to a file
  146.     name before running dvips.    That is, by setting
  147.  
  148.     set DVIPS_STDERR=error.msg
  149.  
  150.     all messages from dvips will be saved in the file "error.msg".
  151.  
  152.  
  153. KNOWN BUGS/PROBLEMS/LIMITATIONS:
  154. --------------------------------
  155.     - Compressed (.gz) graphics files are not supported on DOS/Win95/98.
  156.     - Problem with partial font downloading for some Chinese PS fonts.
  157.     - Data corruption for binary EPS files if "%%BeginBinary: #" is missing.
  158.  
  159.  
  160. CHANGES:
  161. --------
  162.     May 11, 1997
  163.         - Initial release of dvips 5.72 for OS/2+DOS
  164.  
  165.     May 22, 1997
  166.         - Fixed SIGTRAP by -RO option of RSX on Win95.
  167.         - Long file name support on Win95/NT now doesn't need -RO
  168.           option of RSX. (Thanks to Ian Bruce and Allin Cottrell
  169.           for their testing dvips on Win95.)
  170.         - Fixed partial ps fonts download (-j) bug.
  171.         - Renamed epsgzip.cmd to psgzip.cmd.
  172.  
  173.     July 4, 1997
  174.         - dvips 5.74 for OS2/DOS/emTeX
  175.         - Patched document dvips.tex (dvips.ps) for OS/2 & DOS section
  176.         - afm2tfm.exe was broken in dvips572.zip
  177.         - Fixed append problem with mfjob file creation (-pj) on OS/2
  178.         - patched sources (emdir.c, emdir.h) and makefile for djgpp by
  179.             Hartmut Schirmer (hsc@techfak.uni-kiel.de)
  180.         - Ignore DVIWIN inverse search specials
  181.  
  182.     July 9, 1997
  183.         - Removed Ctrl-Z when including gzipped EPS graphics (OS/2).
  184.         - fixed popen() mode (OS/2)
  185.  
  186.     October 9, 1997
  187.         - dvips 5.76 for OS2/DOS/emTeX
  188.  
  189.     October 18, 1997 (not released)
  190.         - DVIPS_STDERR env to redirect stderr to a file.
  191.         - Removed path info of dvips program in %DVIPSCommandLine:.
  192.         - Fixed ':' problem in output device names. (':' may be added.)
  193.         - New option 'F' (add Control-D) for configuration file.
  194.         - Modified maketexp.{bat,cmd} for automatic font generation
  195.  
  196.     December 6, 1997 (not released)
  197.         - fixed bug with binary sections (%%BeginBinary) of EPS files.
  198.           (new CR-LF codes)
  199.  
  200.     December 17, 1997
  201.         - faster (> 10x) processing speed for DOS EPSF binary files.
  202.  
  203.     December 20, 1997 (not released)
  204.         - fixed seek error of popen stream (gzipped DOS EPSF bin file)
  205.  
  206.     November 19, 1998
  207.         - dvips 5.83
  208.  
  209. HOW TO REBUILD:
  210. --------------
  211.  
  212. If you want to recompile, you need to get the original dvips package
  213. (dvips583.tar.gz) from a CTAN site:
  214.  
  215.     ftp.cdrom.com, ftp.dante.de, ...:
  216.     /pub/tex/dviware/dvips/dvips583.tar.gz
  217.     /tex-archive/dviware/dvips/dvips583.tar.gz
  218.  
  219. (1) Unpack the original sources in a dir on a HPFS partition, as my makefiles
  220.     are written for long file names.  I didn't care about FAT (8.3 names).
  221.  
  222. (2) Then unpack patsrc.zip in dvips583\ dir. (chdir dvips583 then unzip.)
  223.     (All necessary patched/additional source files are now in dvips\patch\.)
  224.  
  225. (3) Now go into dvips\ dir and run "patch\update.cmd". (Sorry for DOS user.)
  226.     This will rename the original source files and copy the patched and
  227.     additional files from patch\*.
  228.  
  229. (4) Now it's ready to rebuild:  Using GNU make, do one of the following:
  230.  
  231.     make -f makefile.emx          create the regular dvips32.exe
  232.  
  233.     make -f makefile.emx allhps       create dvihps32.exe with HyperPostScript
  234.  
  235.     ** Get RunFor from
  236.         ftp://hobbes.nmsu.edu/pub/os2/util/batch/runfor19.zip
  237.         ftp://ftp.cdrom.com/pub/os2/diskutil/runfor19.zip
  238.  
  239.     ** djgpp v2 users use makefile.dj2 instead, after copying it from patch\.
  240.        (makefile.dj2 is due to Hartmut Schirmer (hsc@techfak.uni-kiel.de).)
  241.  
  242.     Make sure the source directory is cleaned before you rebuild again.
  243.     You can clean the source directory by:    make -f makefile.emx clean
  244.  
  245.     Other make targets (e.g. install, installhps, zipexe, zipsrc, zipcontrib)
  246.     are to create zip archives for distribution.
  247.  
  248. That's it!
  249.  
  250.  
  251. /*----------------------------------------------------------------------*/
  252. Wonkoo Kim (wkim+@pitt.edu)
  253.