home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / tex / !dvips / !ReadMe < prev    next >
Text File  |  1995-01-20  |  10KB  |  334 lines
  1.  
  2.                            ——————
  3.                            !dvips
  4.                            ——————
  5.  
  6.                     (dvips 5.55) [Arc1.1]
  7.  
  8.  
  9. 0 Contents
  10. ——————————
  11.  
  12.  1 Simple use
  13.      1.1 Use with the DDE
  14.      1.2 Use with !DaTeX
  15.      1.3 Use with the CLI only
  16.      1.4 NOTE: Automatic creation of font files
  17.      1.5 Getting hard copy
  18.      1.6 If you don't have the DDE modules
  19.  2 Documentation
  20.  3 Differences from dvips in a Unix environment
  21.  4 The unreasonably large wimpslot
  22.      4.1 Running in less memory
  23.      4.2 MakePKs - creating all your PK fonts files
  24.  5 The TeX macro files psfig.tex and psfig.sty
  25.  6 Copyright
  26.  7 Warranty
  27.  8 Bugs
  28.  9 To-Dos
  29. 10 Problems of the insurmountable kind
  30.  
  31.  
  32.  
  33.  
  34. 1 Simple use
  35. ————————————
  36.  
  37. This is a port of dvips 5.55.  Using it should hopefully be
  38. simplicity itself.
  39.  
  40.  
  41. 1.1 Use with the DDE
  42. ————————————————————
  43.  
  44. Run !dvips after !TeX and !TeXFonts have been seen by the filer. 
  45. Now take your dvi file say, doc.dvi, and drop it, or the directory
  46. in which it is contained (ie. doc), on to the dvips icon.  This
  47. should result in a PostScript file, doc.ps in this case, being
  48. produced.
  49.  
  50.  
  51. 1.2 Use with !DaTeX
  52. ———————————————————
  53.  
  54. Make sure that you have shown the filer !dvips, !TeX, and
  55. !TeXFonts before the first print request after loading !DaTeX. 
  56. The minimium setting for the amount of allocated memory is
  57. 960K———see §3.2.5 of the file `!DaTeX.!Help'——— (although see §4
  58. below).
  59.  
  60.  
  61. 1.3 Use with the CLI only
  62. —————————————————————————
  63.  
  64. Make sure that you have shown the filer !dvips, !TeX and !TeXFonts
  65. to set up the necessary environment varibles.  To run dvips on a
  66. dvi file, say doc.dvi, type,
  67.  
  68.    dvips doc.dvi
  69.  
  70. or just
  71.  
  72.    dvips doc
  73.  
  74. while ensuring that you have a wimpslot of at least 960K (although
  75. see §4 below). This should produce a PostScript file, doc.ps in
  76. this case.
  77.  
  78.  
  79. 1.4 NOTE: Automatic creation of font files
  80. ——————————————————————————————————————————
  81.  
  82. dvips will attempt to make any font files that it can not find. 
  83. If your distibution of armTeX didn't come with any PK font files,
  84. or if you have removed them from your hard disc to free up some
  85. space, processing your first set of dvi files may take some time. 
  86. Each time a file is found to be missing METAFONT is called on to
  87. produce it, and it is placed  in a cache directory
  88. (!dvips.Fonts.Cache).  After a while this will contain all the
  89. fonts you regularly use, and making fonts will become a rarer and
  90. rarer occurance.  From time to time, or when the directory becomes
  91. full, you can move the PK files into their correct places in the
  92. directory/ies where your fonts are normally kept (probably within
  93. !TeXFonts).
  94.  
  95.  
  96. 1.5 Getting hard copy
  97. —————————————————————
  98.  
  99. The resulting PostScript file can then be printed by dropping on
  100. to !Printers.
  101.  
  102.  
  103. 1.6 If you don't have the DDE modules
  104. —————————————————————————————————————
  105.  
  106. I have seen comment that people providing DDE based interfaces for
  107. command line based programs———!dvips being cited here———are just
  108. being lazy in not providing a `proper' wimp interface.  If you
  109. don't have the DDE modules (and even if you do) you should take a
  110. look at David Arnold's !DaTeX, or Dick Alstein's !SemTeX.  Both
  111. provide a competent, and _integrated_ wimp interface to all things
  112. TeX related (although at present !DaTeX has more `nobs').  I see
  113. no reason to duplicate work.  Both !DaTeX and !SemTeX are available
  114. from Hensa.
  115.  
  116.  
  117.  
  118.  
  119. 2 Documentation
  120. ———————————————
  121.  
  122. Documentation can be found in !dvips.Documents.  A very thorough
  123. desciption of dvips can be found in the file dvips.tex, written by
  124. the program's author.  The file test.tex provides a suitable
  125. simple test to ensure that dvips is working roughly as it should
  126. be.  Also in the Documents directory are two processed man pages:
  127. One for dvips and one for afm2tfm———an auxilary program for use
  128. with dvips.
  129.  
  130.  
  131.  
  132.  
  133. 3 Differences from dvips in a Unix environment
  134. ——————————————————————————————————————————————
  135.  
  136. Hopefully the only ways in which dvips differs from the descption
  137. given in dvips.tex relate to the changes I've made to make it sit
  138. better under RISC OS.
  139.  
  140. Mark Sinke's armTeX takes as a convention that any default paths
  141. are completely replaced by environment varibles, !dvips adheres to
  142. this, and also has the same default paths as armTeX.  Note,
  143. however, that paths given in config files will be added to the
  144. head of the list of paths so far.  !dvips also has the armTeX
  145. concept of a `current selected directory.'  That is if !dvips is
  146. presented with a file with an absolute path it will take the
  147. grandparent directory of the file to be the CSD.  I.e. the file,
  148.  
  149.    ADFS::IDEDisc4.$.MyFiles.Docs.Fruit.tex
  150.   
  151. will result in
  152.  
  153.    ADFS::IDEDisc4.$.MyFiles.Docs
  154.   
  155. being taken as the CSD.  This means that you should put all files
  156. to be included into the TeX file that don't thave absolute path
  157. names, relative to this.  For example,
  158.  
  159. \include{banana.tex}
  160. \epsffile{grape.ps}
  161.  
  162. will look for the files,
  163.  
  164.    ADFS::IDEDisc4.$.MyFiles.Docs.banana.tex
  165.    ADFS::IDEDisc4.$.MyFiles.Docs.grape.ps
  166.  
  167. respectively, regardless of the true CSD.  Any path name that
  168. doesn't change with a change in your true CSD is considered to
  169. constitute the use of an abosulte path, so &.apple.tex etc. count.
  170.  
  171. Any references to ~ the Unix home directory should be taken to
  172. refer to the URD, &, and .dvips to !dvips. 
  173.  
  174.  
  175.  
  176.  
  177. 4 The unreasonably large wimpslot
  178. —————————————————————————————————
  179.  
  180. As !dvips for the DDE stands, running dvips takes a wimpslot of
  181. 960K.  Such a slot is only necessary if you are going to allow the
  182. automatic generation of missing PK font files from within dvips. 
  183. To generate the missing files, dvips calls on METAFONT to make
  184. them.  As this must also run in the same slot, a pretty big one is
  185. needed.  If you ever set it too small dvips will inform you and not
  186. call METAFONT.
  187.  
  188.  
  189. 4.1 Running in less memory
  190. ——————————————————————————
  191.  
  192. If you are lucky enough to have enough secondary store to hold all
  193. the PK files that you're ever going to need, or if you always
  194. disable the automatic generation with the -M option, then a much
  195. smaller initial wimpslot of 128K will surfice.
  196.  
  197.  
  198. 4.2 MakePKs - creating all your fonts files
  199. ———————————————————————————————————————————
  200.  
  201. If you have a large hard disc you may want to create all the PK
  202. font files you are every likely to need and store them away on
  203. disc.  The program MakePKs knows about a large number of commonly
  204. used fonts and the various sizes at which they are commonly
  205. needed.
  206.  
  207. You run MakePKs from the command line giving it as an arguement
  208. the number of dots per inch of the printer you want the fonts
  209. creating for.  MakePKs will then look at each METAFONT file you
  210. have, and if you are missing a common PK file that is made from
  211. the METAFONT file, it will preceed to request METAFONT to make it. 
  212. That is unless it's already in the dvips chache directory, in
  213. which case it just moves it to its rightful place.  As an example
  214. you might use,
  215.  
  216.    MakePKs 600
  217.    
  218. to fill in the missing common PK files for use with a 600 dpi
  219. printer.
  220.  
  221. WARNING: if you are missing a lot of fonts MakePKs will take quite
  222. some time.  If you want to carry on using your computer using a
  223. TaskWindow is a good idea.
  224.    
  225.  
  226.  
  227.  
  228. 5 The TeX macro files psfig.tex and psfig.sty
  229. —————————————————————————————————————————————
  230.  
  231. The macro files psfig.tex and psfig.sty are not part of the
  232. original dvips 5.55 distibution.  They are by Trevor J. Darrell
  233. and hence have a seperate copyright, which can be found at the
  234. head of the files.  I have included them as they are my preferd
  235. way to get PostScript files into (La)TeX documents.  Unlike
  236. epsf.tex/sty which just looks for a bounding box in a PostScript
  237. files head, psfig.tex/sty will search from beginning to end for a
  238. bounding.  This is very usefull as the PostScript files produced
  239. by !Printers have their bounding boxes at their ends.  Hence you
  240. do not have to edit the file by hand as suggested by the
  241. documentation in epsf.tex/sty.
  242.  
  243.  
  244.  
  245.  
  246. 6 Copyright
  247. ———————————
  248.  
  249. dvips is copyright by Thomas Rokicki.  The head of the source file
  250. dvips.h states:
  251.  
  252.   `This is dvips, a freely redistributable PostScript driver
  253.    for dvi files.  It is (C) Copyright 1986-94 by Tomas
  254.    Rokicki. You may modify and use this program to your
  255.    hea