home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume15 / tpscript / part04 / READ_ME.TOO
Encoding:
Text File  |  1988-05-25  |  7.4 KB  |  171 lines
  1. GENERAL REMARKS            (by Axel Mahler, axel@coma.uucp)
  2.  
  3. This is 'tpscript', a free ditroff to PostScript filter package.
  4. Tpscript was originally written by Stephen Frede who was with the
  5. University of New South Wales, Australia, when he wrote the programs.
  6.  
  7. Stephen posted the whole package to net.sources about two years ago.
  8. A while ago, I made a first attempt to repost the 'tpscript' package
  9. (and some local improvements), but failed due to mail problems.
  10. However, I asked Stephen for permission, and this is what he answered:
  11.  
  12. >Date: 26 Nov 86 12:24:44 +1100 (Wed)
  13. >From: tub!unido!gris.oz!stephenf (Stephen Frede)
  14. >To: coma!axel
  15. >Subject: Re: posting of tpscript modifications
  16. >
  17. >By all means, post the modified sources. Since I posted the original
  18. >version, I have moved from university to private industry, and the
  19. >company I work for (Softway) now sells a much enhanced version of the
  20. >original package, which incidentally allows external graphics objects
  21. >to be incorporated, as well as many more features not present in the
  22. >original version. Needless to say, the latest version is very much
  23. >protected and will not be distributed over the net. But the first
  24. >version was developed under an educational UNIX license, and under
  25. >the terms of that license, any software developed must be made freely
  26. >available (NOT public domain - no-one else can sell it). So go ahead
  27. >and post.
  28. >
  29. >Thanks for checking with me - I look forward to seeing your
  30. >modifications.
  31. >
  32. >By the way, if you are ever looking for UNIX software such as an
  33. >enhanced PostScript driver or whatever, consider the advantages of
  34. >buying from Australia - the exchange rate makes us quite cheap
  35. >compared to European and US vendors. In fact if you send me your
  36. >real mail address, I'll mail you some samples from the latest
  37. >version.
  38. >
  39. >                        Stephen Frede
  40. >
  41. >                ...!seismo!softway.oz!stephenf
  42. >
  43. >                Softway Pty Ltd
  44. >                P.O. Box 305
  45. >                Strawberry Hills NSW 2012
  46. >                AUSTRALIA
  47. >
  48. >                Phone +61 2 698 2322
  49. >
  50. >
  51. >
  52.  
  53. (Sorry that it took so long to really repost the stuff.)
  54.  
  55.  
  56. ABOUT THIS DISTRIBUTION
  57.  
  58. There's a main Makefile (I never used it), a shell script that facilitates
  59. the invocation of ditroff (I never used it either) and three directories:
  60.  
  61.   - opscript: contains a plain ascii to PostScript conversion program
  62.     (lpscript), and a bitmap to PostScript conversion program (ipscript).
  63.     'lpscript' is suitable for use as an output filter for the
  64.     lineprinter spooler system. 'ipscript' has seldomly been used
  65.     and (if I recall it right) caused some trouble. 
  66.  
  67.   - tpscript: contains the ditroff to PostScript conversion program,
  68.     'tpscript'. We use 'tpscript' extensively, literally every day.
  69.     The operating environment we have is a MicroVAX II, running
  70.     4.3BSD with DWB 1.0 (or 1.2, I'm not certain) (di)troff, and 
  71.     an Apple LaserWriter Plus. However, there's nothing BSD specific
  72.     that would keep 'tpscript' from running on any sensible Unix
  73.     system. 
  74.     The subdirectory tpscript/devalw contains the font width tables
  75.     for the standard-fonts. 
  76.  
  77.   - pscript: contains a collection of PostScript source files. These
  78.     files are either demos/samples or little utilities for producing
  79.     font descriptions or page setups.
  80.  
  81.  
  82. IMPRESSION / REVIEW OF TPSCRIPT    
  83.  
  84. 'tpscript' is a great piece of software, and we are most gratefull to
  85. Stephen Frede for writing and publishing it. We have used it on a daily
  86. basis for about two years now, and are nothing but satisfied. (In fact,
  87. some colleagues at our department, who distrusted 'netware', and kept
  88. faith in 'supported products', had a lot more trouble with a major
  89. product in the field on a SUN 3 network.) 
  90.  
  91. I have a vague memory of a problem with our troff, not being able
  92. to hold enough font slots. This imposed a hard limit on the number
  93. of different types accessible from within a troff source file. We
  94. fixed that in our troff version (DWB 1.0 or so). I hope this gotcha
  95. is fixed with more recent releases of ditroff.
  96.  
  97.  
  98. FEATURES
  99.  
  100. Features of 'ipscript' and 'lpscript' are described in corresponding 
  101. manual entries. 'tpscript' is used as a filter, i.e. it reads its input
  102. from stdin and sends its output to stdout. The fonts used are the most
  103. commonly available on PostScript devices: Times, Helvetica and Courier.
  104. With some fiddling around it is possible to add support for other fonts
  105. (we did that for the Bookman family of fonts).
  106.  
  107. Besides some minor fixes to the program, the most notable enhancement
  108. we added with respect to the original 'tpscript' version is the 
  109. 'E' directive. This directive allows to specify a unix command (with 
  110. arguments) to be invoked by 'tpscript', and insert the output of
  111. that command into the output stream of 'tpscript'. The 'E' directive
  112. facilitates inclusion, and appropriate scaling of externally created
  113. PostScript images (e.g. MacDraw or GemDraw) in troff-formatted documents.
  114. _______________________________________________________________________________
  115. | The typical use of this feature is illustrated by a macro that we           |
  116. | wrote for this purpose (to be used with ms):                      |
  117. |                                           |
  118. | .nr Ph 1        \" Initialize picture-numbering-              |
  119. | .nr Pn 0        \"            registers              |
  120. | .if '\\*(Fg'' .ds Fg Abb.                              |
  121. | .de Pc    \" Insert Picture --- .Pc title height filename alignment     |
  122. | .KS                \" ms dependent keep                  |
  123. | .sp \\$2+2v            \" vertical space for picture (2 lines frame) |
  124. | .if !\\n(Ph=\\n(H1 \{ .nr Ph \\n(H1 \" if new chapter - save chapter number |
  125. | .nr Pn 0 \}            \"    - initialize Picture-number          |
  126. | .nr Pn \\n(Pn+1            \" increase picture-number          |
  127. | .ce                                           |
  128. | \f3\*(Fg \\n(Ph.\\n(Pn.\f1 \\$1    \" write picture Title              |
  129. | .KE                \" release keep                      |
  130. | .if !'\\$3'' \{            \" if a filename is given          |
  131. | .if \\n(.P \{            \" and if page should be printed          |
  132. | .nr Vp \\n(nl-\\$2-2v        \" In,Vp upper left corner of picture          |
  133. | .nr In \\n(.o-32+\\n(.i        \" 32 is a LW+-correction          |
  134. | .nr He \\$2            \" Picture height given by caller          |
  135. | .nr Wi \\n(.l-\\n(.i        \" Picture width (line len. - cur. indent)    |
  136. | \!E /usr/local/lib/gem2ps -V\\n(Vp -I\\n(In -H\\n(He -W\\n(Wi -A\\$4 \\$3   |
  137. | .rr Vp                                      |
  138. | .rr In                                      |
  139. | .rr He                                      |
  140. | .rr Wi                                      |
  141. | \}                                          |
  142. | \}                                          |
  143. | .br                                          |
  144. | ..                                          |
  145. |_____________________________________________________________________________|
  146.  
  147.  
  148. INSTALLATION AND CONFIGURATION
  149.  
  150. There are two important entries in 'tpscript's Makefile: 'tpscript' and
  151. 'tpsgem'. "make tpscript" will produce the default tpscript version, just
  152. a ditroff to PostScript filter. It includes full support for PIC but no
  153. explicit support for any kind of externally generated PostScript code.
  154. If you "make tpsgem", you'll obtain a slightly different version of
  155. 'tpscript', including a specially modified PostScript prolog supporting
  156. PostScript images produced by 'gem2ps', our local GEM metafile to 
  157. PostScript conversion utility (this is a variant of the program 'mfps'
  158. which has been posted to comp.sys.atari.st). 'tpsgem' has no support
  159. for PIC graphics ! 
  160.  
  161. > In case you want to include images produced on a Mac, you'll have to
  162. > modify 'tpscript.c' (contains most of the prolog). Basically, you'll have
  163. > to swap 'Gem2PsDict' with an equivalent 'LaserPrep'.
  164.  
  165. This situation is kind of unsatisfying, but for me, there has always
  166. been some other task that had to be accomplished. It would clearly be
  167. desirable to have some sort of library for various PostScript prologs
  168. that would be selected depending on an option. Maybe somebody finds
  169. the time to add this to the program.
  170.  
  171.