home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 7 / FreshFishVol7.bin / bbs / text / dvips-5.58.lha / DviPS / README.amiga < prev    next >
Text File  |  1994-09-28  |  12KB  |  361 lines
  1. *
  2. * dvips v5.58
  3. *
  4. * Amiga port by Giuseppe Ghibò <ghibo@galileo.polito.it>, based on
  5. * the official Unix v5.58 distribution released on 13rd Sep 1994.
  6. *
  7. * Last revised 29th Sep 1994.
  8.  
  9. ---------------
  10. About this port
  11. ---------------
  12.  
  13. This is the Amiga port of dvips v5.58.
  14.  
  15. All original directories are left unchanged from the official Unix
  16. distribution, except for dvips/contrib/psfig which has been substituted
  17. with the latest version (1.10) of Trevor Darrel's 'psfig.sty' (look at
  18. dvips/contrib/psfig-tex).
  19.  
  20. All Amiga changes are enclosed in #ifdef AMIGA ... #endif pairs.
  21.  
  22.  
  23. ----------
  24. Path rules
  25. ----------
  26.  
  27. Amiga paths (in environment variables and config files) follow this
  28. rules yet used on others PD version of TeX, and different from the ones
  29. described in dvips.tex):
  30.  
  31.  - a period "." indicates the current directory.
  32.  - a comma "," is the paths separator (instead of Unix ":").
  33.  - two adjacent commas ",," includes the default pathname into
  34.    that path.
  35.  
  36.  
  37. ----------------
  38. Backtick support
  39. ----------------
  40.  
  41. The backtick special "`" (see §4.7 of dvips manual) is also supported,
  42. either through the Bojsen's APipe-Handler (you can find it on AmiNet in
  43. util/shell/APipe-37.5.lzh) or through a very rough version of a read only
  44. pipe (the latter will be used in the case you haven't installed the
  45. APipe-Handler).
  46.  
  47. This version supports pipes to printers (e.g., dvips -o!lpr ...) only through
  48. the APipe-Handler. If you want, instead, to send the output directly to a
  49. PostScript printer connected, for instance, to the parallel port, you may use
  50. "dvips -opar: dvifile". Note that `dvips -o!lpr' is just an example, the
  51. Amiga doesn't have really the 'lpr' program (as far as I know...).
  52.  
  53. The backtick special "`" is supported also by the 'psfig' package (provided).
  54. Using this feature you may keep your Encapsulated PostScript files in a
  55. crunched form. To use this feature you must have the 'GZip' program (look in
  56. Aminet) renamed to 'ZCat'.
  57.  
  58.  
  59. -----------
  60. Amiga files
  61. -----------
  62.  
  63. This distribuition of dvips contains the following Amiga files:
  64.  
  65. README.Amiga      this file.
  66. afm2tfm           binary version of afm2tfm.
  67. dvips             binary version of dvips for any users.
  68. dvips040          binary version of dvips for 68040 users.
  69. smakefile         Makefile for SAS/C v6.x.
  70. ps/config.ps      config.ps for 300 dpi laser printer (Canon engine).
  71. ps/config.ljfour  a config file for HP LaseJet IV (600×600 dpi²).
  72. ps/config.nechi   a config file for Nec 24pin (360×360 dpi²).
  73. ps/config.nec     a config file for Nec 24pin (180×180 dpi²).
  74. ps/config.generic a config file for generic PostScript printer.
  75. ps/*.map          extra maps file to use Paradissa fonts collection.
  76. ps/*.pro          PostScript prologue files.
  77. MakeTeXPK         a shell script file for automatic pk fonts creation.
  78. texc.rexx         ARexx script to convert tex.lpro to texc.lpro.
  79. pipe.c            code to implement 'popen' and 'pclose' functions.
  80. rexx.c            ARexx interface to make dvips compatible with PasTeX.
  81. include/          directory with prototypical headers.
  82. env-vars          a shell script to set some environment variable.
  83. dvips.dvi         DVI documentation of dvips.
  84.  
  85.  
  86. ---------
  87. Compiling
  88. ---------
  89.  
  90. To compile source files on your Amiga, CD on dvips directory then type from
  91. your current shell `smake -f amiga/smakefile all'.
  92.  
  93. To compile sources on CPUs different from 68000, you can use instead
  94. `smake -f amiga/smakefile CPU=68040 MATH=8'.
  95.  
  96. To compile sources with the optimization disabled you can use for instance
  97. `smake -f amiga/smakefile dvips OPTMZ='
  98.  
  99. To install the compiled sources and PostScript prologue files into TeX
  100. directories type `smake -f amiga/smakefile install'.
  101.  
  102.  
  103. ------------
  104. Installation
  105. ------------
  106.  
  107. If you don't intend to recreate all binaries and prologue files using
  108. the smakefile, copy the following files:
  109.  
  110.     dvips/amiga/ps/#?
  111.     dvips/psfonts.map
  112.     dvips/psdraft.ps
  113.  
  114. to your TeX-PostScript directory (e.g., TeX:ps/) and then edit the file
  115. config.ps according to your paths (pk, tfm, vf, ...). An alternative to change
  116. the config file(s) is to set the environment variables. In fact some
  117. environment variables override paths and options specified in the config
  118. file(s). To do this you can modify the file `dvips/amiga/env-var' to match
  119. your own paths.
  120. Note that directory `dvips/amiga/ps/' contains the latest version of the
  121. PostScript prologue files (*.pro) used by dvips. *BE SURE* you have installed
  122. these files on your TeX PostScript directory, otherwise dvips will produce
  123. fault PostScript files.
  124.  
  125. Then copy the binary version of 'dvips' (according to your CPU) and 'afm2tfm'
  126. and 'squeeze' into your TeX-binary directory (e.g., TeX:bin/).
  127.  
  128. Finally copy the file 'MakeTeXPK' into your TeX-scripts directory
  129. (e.g., TeX:s).
  130.  
  131. For further information process the dvips manual `dvips.tex' (using
  132. plain TeX) or see the dvi file `amiga/dvips.dvi'.
  133.  
  134.  
  135. -------------------------
  136. Automatic font generation 
  137. -------------------------
  138.  
  139. For automatic font generation (see §10 on page 35 of dvips manual), it is
  140. provided a shell script file named 'MakeTeXPK'.
  141.  
  142. Note that this port of dvips has new features (not available in the
  143. Rokicki's Unix version) for the MakeTeXPK env var.
  144.  
  145. On page 37 of the dvips manual are explained the standard arguments
  146. supported by MakeTeXPK env var. This port now supports also four new
  147. arguments:
  148.  
  149.   %x = horizontal base resolution (dpi), i.e. the one specified after the
  150.        `X' in the config file.
  151.  
  152.   %y = vertical base resolution (dpi), i.e. the one specified after the
  153.        `Y' in the config file.
  154.  
  155.   %p = a %p will be replaced by the first expansion of the pk path. For
  156.        instance, if you have these lines in your config file:
  157.  
  158.            D 600
  159.            M ljfour
  160.            P TeX:texfonts/pk/%m/%d/%f.%dpk,TeX:pk/%d/%f.%dpk,%f.%dpk
  161.  
  162.        and, for instance, the font cmssbx10 at magstep(0.9) isn't found,
  163.        then %p will be replaced by the following string:
  164.  
  165.            TeX:texfonts/pk/ljfour/540
  166.  
  167.   %P = a %P is like %p except the path has truncated also the directory
  168.        before the font name. If we consider the example above, a %P will
  169.        be replaced by:
  170.  
  171.            TeX:texfonts/pk/ljfour
  172.  
  173. Note that the %w (available in the port of version 5.55) used to
  174. substitute the MF mode is no longer supported. In fact, now, the the official
  175. dvips has the %o argument, which performs the same things of the old %w.
  176.  
  177. Note, if dvips doesn't found more than one pk font, then the file
  178. 'missfont.log' will be created/appended. In this case just execute that
  179. file by typing from your shell 'execute missfont.log'.
  180.  
  181. If you have the ARexx script 'MakeBatch.rexx' and 'MakeTeXFont.rexx'
  182. provided with PasTeX you can set the environment variable MAKETEXPK to
  183.  
  184.     rx MF:rexx/MakeBatch %n %d %x %y PS %d/%n.%dpk %P/
  185. or
  186.     rx MF:rexx/MakeTexFont %n %d %x %y PS %d/%n.%dpk %P/
  187.  
  188. to do the automatic font creation.
  189.  
  190. Starting from v5.55 rev 2, it is supported the CALLMF env var. If the
  191. environment MAKETEXPK is setted to the value "CALLMF" (without quotes) or
  192. it is not at all setted, then will be called the ARexx script specified
  193. by the environment variable CALLMF itself. For instance let's consider:
  194.  
  195.     setenv MAKETEXPK CALLMF
  196.     setenv CALLMF MF:rexx/MakeBatch.rexx
  197.  
  198. then the ARexx script `MF:rexx/MakeBatch.rexx' will be called if
  199. a fonts isn't found. The arguments passed to the ARexx script
  200. are the ones needed by the PasTeX's ARexx scripts `MakeBatch.rexx'
  201. or `MakeTeXFont.rexx'. The advantage to use of CALLMF with respect to
  202. set the enviroment variable MAKETEXPK to `rx MF:rexx/MakeBatch ...',
  203. is that if the ARexx server isn't active then the ARexx script
  204. isn't executed, while `rx' command starts anyway the ARexx server.
  205.  
  206.  
  207. ----------
  208. Some notes
  209. ----------
  210.  
  211. If you are using dvips with a PostScript interpreter like Post, keep in
  212. mind that the PostScript file produced by dvips using pk fonts isn't
  213. 'device indipendent'. For instance, if you want to print on a 180dpi dot
  214. matrix printer you must have the correct pk size fonts. An alternative is to
  215. use Type 1 PostScript fonts. For this purpose you may retrieve all the
  216. CM and AMS fonts in Type 1 format (Paradissa Font Collection) from
  217. any CTAN archive. To use such fonts,