home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d796 / pstools.lha / PSTools / PSTools.doc < prev    next >
Text File  |  1993-01-10  |  6KB  |  174 lines
  1.                             DVIPS / PSUTILS
  2.                             ===============
  3.  
  4.                                Amiga Port
  5.                                    by
  6.                             Jonathan Hudson
  7.  
  8.                             
  9. This is a compilation of PostScript (tm) tools for the AMIGA. It's
  10. split into two areas, DVIPS and PSUTILS.
  11.  
  12. DVIPS is a program that takes TeX .DVI files and converts them to
  13. PostScript files.
  14.  
  15. PSUTILS are a collection of programs for manipulating PostScript files,
  16. for example to extract all odd (or even) pages, useful for double sided
  17. printing.
  18.  
  19. If you haven't got a PostScript printer, you can still take advantage
  20. of the great amount of useful documentation in TeX .dvi or PostScript
  21. .ps format, using the incredibly excellent POST program from the Fish
  22. Disk 669.
  23.  
  24. DVIPS
  25. =====
  26.  
  27. Why do you need DVIPS ? Well a lot of AMIGA programs, particularly
  28. development tools, are ported from the Unix environment (as is DVIPS),
  29. where TeX is a commonly used text formatter (or should I say type
  30. setter). Examples are Indent (FF702), Bmake (FF523) and the version of
  31. GNU RCS that I'm currently working on. The quality of the documentation
  32. presentation (to say nothing of the content) is VERY high. If you want
  33. to know how these programs work, you've got to find a way to read the
  34. .dvi files. As the porter of Indent says "as most people don't have
  35. TeX, I've included the .DVI file". Thanks, but maybe most people don't
  36. have a DVI previewer either, this is where DVIPS comes in.
  37.  
  38. So to get a readable version of a .dvi file, do the following.
  39.  
  40. 1.  > dvips file.dvi -o file.ps    ; convert .dvi to .ps
  41.  
  42. 2.  > post init.ps file.ps to screen   ; view the .ps file
  43.  
  44. 3. Optionally split the file into odd and even pages for printing
  45.  
  46.     > psselect -o file.ps oddpages.ps
  47.     > psselect -e file.ps evenpages.ps
  48.  
  49. 4. If you've got a DeskJet or LaserJet, print it out using postlj
  50.  
  51.     > postlj init.ps oddpages.ps
  52.     (now put page in again, other side up)
  53.     > postlj init.ps evenpages.ps
  54.  
  55. If you've got another  preferences printer, use post to output the .ps
  56. file(s), if you've got a PostScript printer, then just print the .ps
  57. file(s). Easy really.
  58.  
  59. Amiga Implementation
  60. ====================
  61.  
  62. The source came from the 1992 DECUS Europe Symposium CD-ROM. It is as:
  63.  
  64. (dir)   afm                         Adobe Font Metric Files 
  65. (dir)   ps                          Config files used by dvips
  66. (dir)   pslatex                     Latex files ???
  67. (dir)   pspks                       TeX pk (font) files
  68. (dir)   pstfms                      TeX tfm (font) files
  69. (dir)   psvfs                       Tex vf (font) files
  70. (dir)   source                      DVIPS source code
  71. Assign-DVIPS                        Amiga script file to set up ASSIGNs
  72.                                     needed by DVIPS
  73. dvips                               The DVIPS Program
  74. dvips.ps                            The DVIPS documentation, if you
  75.                                     haven't got a PostScript printer,
  76.                                     get POST (FF702).
  77.  
  78.  
  79. Logical Name Assignment
  80. =======================
  81.  
  82. The Assign-DVIPS file makes the following assignments.
  83.  
  84.     assign texfonts: work:dvips/pstfms
  85.     assign texvfs: work:dvips/psvfs
  86.     assign texpks: work:dvips/pspks
  87.     assign texconfig: work:dvips/ps
  88.  
  89. A similar configuration will suffice most needs. If your document has
  90. PostScript pictures in it, DVIPS will search for it in TEXCONFIG: or
  91. TEXINPUTS:. You can overide or add assignments using environmental
  92. variables. For example, the documentation for BMake is a file mdoc.dvi,
  93. which includes a PostScript drawing logo.ps. To get DVIPS to include
  94. the drawing in the output PostScript file you must either copy logo.ps
  95. to the texconfig: directory or setenv TEXINPUTS to point to it.
  96.  
  97. Example:
  98.  
  99.     t:docs/mdoc.dvi
  100.     t:docs/logo.ps
  101.  
  102.     > setenv TEXINPUTS t:docs/
  103.     > dvips t:docs/mdoc -o t:docs/mdoc.ps
  104.  
  105. The file paths.h describes the paths used by DVIPS. Note that
  106. enviromental variable path descriptions may include a search list, with
  107. paths separated by a semi-colon.
  108.  
  109.     > setenv TEXINPUTS ";t:docs/;work:pstemp"
  110.  
  111. would search the current directory, t:docs and work:pstemp for any
  112. PostScript figures needed. Directory names amy be specified with or
  113. without a '/', DVIPS will try to cope.
  114.  
  115. PKFonts & METAFONT
  116. ==================
  117.  
  118. DVIPS frequently needs DVI PKFonts for its output (I say frequently, as
  119. I know NOTHING about TeX, so all this tfm, afm, vk pk etc stuff is lost
  120. on me). A common selection is included the TEXPKS directory. If DVIPS
  121. can't find the font here that it needs, it will try to run METAFONT and
  122. gftopk to make the font. It does this by running the MakeTexPK script
  123. (this file MUST be marked as a script file (>Protect MakeTeXPK +s)). The
  124. distributed version of this script does nothing, as I couldn't get the
  125. mf program on the Fish TeX (611-616) disks to work (nor TeX for that
  126. matter). This is left as an exercise for the reader. To assist in this
  127. there are a the original sources (MakeTeXPK-dist, MakeTeXPK-dist.1
  128. and vms/MAKETEXPK.COM (for those who find DCL more intelligible than
  129. shell). If anyone has a PD version of TeX, METAFONT etc that runs on a
  130. 6Mb A3000, I'd like a copy please.
  131.  
  132. Porting Issues
  133. ==============
  134.  
  135. This program compiles using Matt Dillon's wonderful DICE compiler. The
  136. supplied dmakefile is not too clever (use dmake dvips). DVIPS should
  137. compile under other ANSI compilers, but why bother when Matt `gives
  138. away' the best Amiga compiler for $50 ?
  139.  
  140. As Unix code goes, this is exceptional in that it's readable and was
  141. very easy to port (kudos to Matt for this too). The changes are
  142. #ifdef'ed _DCC apart from the cases where floats and shorts were
  143. changed to double and int for sscanfs. It also pretends to be SYSV to
  144. avoid adding more #ifdefs. 
  145.  
  146. The programs work just fine on my v36 library'ed A3000 (2+4 mB). They
  147. may (or not) run on v1.3, from floppies (I think not, unless you do a
  148. lot of disk swapping) or with less memory. Enjoy.
  149.  
  150. We have to use .lpro rather than .pro files, I don't know why, maybe you do ?
  151.  
  152. PSUTILS
  153. =======
  154.  
  155. A selection of PostScript tools to manipulate PS files. Minimal
  156. documentation, compiles with DICE.
  157.  
  158. Author
  159. ======
  160.  
  161. These programs ported by:
  162.  
  163. Jonathan Hudson,
  164. PO Box 5272,
  165. Ruwi,
  166. Sultanate of Oman,
  167. Middle East.
  168.  
  169. Tel : +(968) 699407 (Voice & Fax)
  170.  
  171. I'd be grateful for any bug reports, enhancements etc (and PD
  172. TeX/METAFONT programs :-)
  173.  
  174.