home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume15 / tpscript / part03 / READ_ME
Encoding:
Text File  |  1988-05-25  |  5.2 KB  |  120 lines
  1. Copyright:    1985, Stephen Frede, UNSW Australia
  2.     Use it and copy it as much as you want, but don't pretend you
  3.     wrote it, or sell it for profit.
  4.  
  5. Authorship:    Originally by Stephen Frede.
  6.         Various extensive changes by
  7.             Cameron Davidson and Michael Rourke.
  8.         GEM support added and reliability of PostScript output
  9.         improved by Axel Mahler and Andreas Lampen.
  10.         (axel@coma.uucp/andy@coma.uucp).
  11.  
  12. Contents:
  13.     0) File 'READ_ME', directories 'src', 'src/tpscript',
  14.         'src/opscript', 'src/pscript', 'man', 'devalw'
  15.  
  16.     1) Source for a back end to ditroff which converts ditroff
  17.        output to PostScript (src/tpscript).
  18.  
  19.     2) Font code and width tables suitable for use with ditroff (devalw).
  20.  
  21.     3) A program (lpscript) which converts plain text into postscript.
  22.        various options allow selection of font, size and rotation, etc.
  23.  
  24.     4) A program (ipscript) which converts bitmap images of various sorts
  25.        into postscript.
  26.  
  27.     5) Manual entries for lpscript and ipscript.
  28.  
  29.     6) The directory src/pscript contains some random postscript
  30.        programs that may or may not be useful.
  31.  
  32.  
  33. NOTES:
  34.     The sources should be pretty much bug free. They have been run on
  35.     a few different systems, but I have no doubt that upon releasing it
  36.     to the world, some will come to light. Please mail suggestions
  37.     and fixes directly to me at the address given above.
  38.  
  39.     The troff names for many of the characters were taken from a paper
  40.     about such things from:
  41.         "Adventures with Typesetter Independent Troff", by
  42.     Mark Kahrs and Lee Moore, Dept. Computer Science, University
  43.     of Rochester, Rochester, NY 14627. TR159; June, 1985.
  44.  
  45.     Work is in progress to allow down-line loading of fonts other than
  46.     those available by default in the LaserWriter (or whatever), such
  47.     as the Berkeley fonts.
  48.  
  49.     They have never been run on anything other than a LaserWriter, but
  50.     I don't know of any inherent machine dependencies (other than those
  51.     indicated by "#if ALW").
  52.  
  53.     There are some further changes made by Cameron Davidson to fine tune
  54.     some problems with rounding to pixel boundaries on the LaserWriter
  55.     that are not included in this release.
  56.  
  57.     There are two basica possible approaches to generating postscript
  58.     from some other format. The first is to generate a postscript
  59.     program which then reads input and does the conversion itself.
  60.     The alternative is to do as much of the translation as possible
  61.     first, generating relatively simple postscript commands. This
  62.     is the way these programs work. I have not seen Transcript, by
  63.     Adobe Systems, but I suspect they do it the first way.
  64.  
  65.     Add an entry to the "magic" file that the file(1) command uses
  66.     to look for the characters "%!" at the start of a file.
  67.     This indicates that a file is "PostScript".
  68.  
  69. Installation:
  70.     First you must have ditroff, a device independant troff from ATT,
  71.     requiring a licence. This most usually comes with Documenter's
  72.     WorkBench (DWB). This should include the program "makedev", used
  73.     to "compile" the ascii font tables into binary, so that troff and
  74.     tpscript can read them.
  75.  
  76.     Put all of this stuff into a directory somewhere.
  77.     Edit the Makefile in the top directory and set SYS= one of the
  78.     systems indicated there (AUSAM, V7, SYS5, BSD).
  79.     Then set VERBOSE=1 if you want some needless extra frills. This
  80.     is mainly just identifying jobs by username, etc.
  81.     Set MAKEDEV to be the pathname of the makedev program (in the
  82.     troff source directory ?).
  83.     Then compile it all by saying "make" in the top directory.
  84.     This should generate tpscript, ipscript and lpscript.
  85.     Install them manually in whatever way is appropriate for your system.
  86.     Possibly change the Makefiles to do this. Also note that the
  87.     Makefiles will not do anything smart about .o files or anything
  88.     like that.
  89.     We have installed the real troff in /bin/ditroff and made troff a
  90.     shell script that invokes the appropriate back end. The shell script
  91.     is included here as src/troff.sh, use it if you want.
  92.     Install the manual entries for ipscript and lpscript (from the man
  93.     directory).
  94.  
  95. Possible problems:
  96.     First read the problems section in "Inside LaserWriter".
  97.     Note the various patches from Adobe that have come over USENET.
  98.  
  99.     On some versions of Unix, if the LaserWriter is connected to
  100.     a tty port, and a daemon of some sort continually sends stuff to
  101.     the LaserWriter, but never reads anything, and the LaserWriter
  102.     sends messages back (which aren't read by anyone), then when
  103.     the total number of unread characters reaches a certain amount
  104.     (TTYHOG, 256 or 512 usually), both the input AND output queues
  105.     are flushed, so some characters to the LaserWriter get dropped,
  106.     probably causing a syntax error and the rest of the job to be
  107.     flushed. A good thing to do (even if you don't have this problem)
  108.     is to collect all the output from that line and save it in a file.
  109.     This makes looking at error and other messages from the LaserWriter
  110.     quite easy (tail /tmp/laserout). On BSD machines one may e.g. add
  111.     a line "/usr/ucb/tail +0cf /dev/ttyLW > /usr/spool/lpd/lw/lw-log &"
  112.     to /etc/rc.local.
  113.  
  114.     Note a bug in many versions of eqn(1) which causes a right large
  115.     square bracket to be made of '|' characters instead of "\(bv" chars.
  116.     If you have the source, this is easy to fix.
  117.  
  118.     I don't know what some of the Berkeley ditroff output means.
  119.     If someone would like to fill me in, I'll add it to tpscript.
  120.