home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2760 < prev    next >
Encoding:
Internet Message Format  |  1991-02-15  |  6.9 KB

  1. From: clewis@ferret.ocunix.on.ca (Chris Lewis)
  2. Newsgroups: alt.sources,comp.sources.bugs,comp.text,comp.lang.postscript
  3. Subject: Psroff 2.0 PL7 Notes
  4. Message-ID: <1349@ecicrl.ocunix.on.ca>
  5. Date: 14 Feb 91 06:38:52 GMT
  6.  
  7. Archive-name: psroff2.0/Notes.PL7
  8. Submitted-by: clewis@ferret.ocunix.on.ca (Chris Lewis)
  9.  
  10. [Psroff archive sites, please include this in your psroff area]
  11.  
  12. Some notes on Psroff 2.0, PL7:
  13.  
  14. [A package that converts CAT Troff into Postscript, HP PCL and ditroff]
  15.  
  16. PL7 is the last patch that I will release for psroff 2.0.  I'll
  17. be reissuing psroff in its entirety over one of the moderated
  18. newsgroups sometime reasonably soon as psroff 3.0.  Partially
  19. because of the new ditroff input support feature, and partially because
  20. I made some mistakes in the patches (1 & 7), and there's some minor bits
  21. and pieces that didn't get fixed properly (mostly documentation).
  22. Now that at least one moderated source group seems alive again, it's
  23. a good time for it to go out and be archived properly.
  24.  
  25. Psroff 3.0 will not introduce anything major other than the
  26. ditroff input support, and some additional support files, such
  27. as width tables for HP LJ III built-in fonts.  I will be posting
  28. Ned Batchelder's psnup (a n-up postscript filter) to comp.sources.misc
  29. tonight.  All I've added is a manual page and a shell script to
  30. wrap around the bare postscript that Ned did.   
  31.  
  32. Psroff will remain mainly a CAT Troff converter, and most of the
  33. install scripts will be oriented towards that.  However, ditroff
  34. input support will also be there, and work to the full functionality
  35. of real ditroff, including pic etc.  Except on HP Laserjets, where you'll
  36. be restricted to the point sizes available with CAT troff and there
  37. won't be any PIC support.
  38.  
  39. At the end of this posting is a list of caveats about PL7, plus
  40. work arounds as I know them.  I continue to encourage people who
  41. have trouble with it to contact me.
  42.  
  43. Here's a bare feature list of 2PL7 and 3.0:
  44.     - CAT & ditroff input support, producing postscript, HP LJ
  45.       and ditroff output.   Ditroff input support will be in 3.0.
  46.       (currently under test)
  47.     - Complete CAT and ditroff(output) functionality for Postscript.
  48.     - Complete CAT functionality on HP Laserjets, provided you have
  49.       access to good Roman fonts.  Incremental downloading of fonts
  50.       for optimization.
  51.     - Output optimization capable of reducing the size by a facter
  52.       or 3 or more, improving printer performance by a factor of up
  53.       to 10, and good throughput through psroff/troff2ps itself.
  54.     - Complete CAT to ditroff conversion.
  55.     - Partial ditroff emulation with CAT troff.  Eg: extended character
  56.       set (3.0), drawing, pass-thru etc.
  57.     - Extended pass-thru facilities to permit operation with
  58.       things like psfig, postscript inclusion etc.
  59.     - Compatibility with many other "backends": Sun Pageview (see
  60.       below), AT&T xtroff, X windows xtroff & xditview, psdit
  61.       (Transcript), tpscript, jetroff, HP Laserjet Postscript
  62.       cartridges.
  63.     - Portability with all versions of UNIX and CAT troff.
  64.       (Config isn't the easiest thing in the world, but it appears
  65.       as if psroff is sufficiently parameterized to build and use
  66.       anywhere).  Especially RISC/Ultrix & Apollo (two odd-ball
  67.       versions of CAT troff).
  68.     - Facilities for manipulating fonts, generating width tables, and
  69.       looking at binary printer streams:
  70.     - upload ditroff format width tables from postscript printers.
  71.     - conversion of ditroff width tables to CAT width tables.
  72.     - Display font characteristics, display bitmaps, merge etc.
  73.       for both PK and SFP format fonts.
  74.     - PK to SFP font conversion.
  75.     - PK & SFP to Postscript bitmap font conversion.
  76.     - Font display table generators.
  77.     - CAT troff width table dumper.
  78.     - Automated tool to generate full set of HP fonts and widths
  79.       from TeX font distribution and other sources of PK's and
  80.       SFP's.
  81.     - HP Laserjet HP PCL dumper, including a primitive HP LJ
  82.       to Postscript converter.
  83.     - Automated build scripts and configuration testers to make
  84.       configuration easier and do all of the things necessary
  85.       to produce the fonts and width tables and install them.
  86.     - Width tables for Postscript printers and HP Laserjet III (in
  87.       3.0), plus automated tools to build them from the supplied
  88.       (and user-supplied) Laserjet fonts.
  89.     - An S font in all CAT troff sizes for HP Laserjets.
  90.     - Manual pages for the useable stand-alone tools.
  91.     - Adapters for -mm, -ms, -man and -me to adjust them to work
  92.       best with psroff.
  93.     - Psroff shell script can be configured by parameter files.
  94.     - Psroff shell script intended to be a "troff" replacement,
  95.       in that the arguments are a superset of standard troff and
  96.       does the same things.
  97.     - Arbitrary order Postscript page flipper, which will produce
  98.       page reversal, "book order", etc.
  99.     - Testing facilities.
  100.  
  101.  
  102. Issues/Clarifications with Psroff 2.0 PL7:
  103.     1) Line starting with "%!" should be removed from lib/ps.lib, it
  104.        confuses Pageview.
  105.     2) Box corner characters (\(lt, \(rt, \(lb, \(rb) use Postscript
  106.        reversepath operator which isn't implemented in Pageview.
  107.        Work arounds are being investigated - contact me if you need
  108.        fixes.
  109.     3) if you pipe something into psroff without the "-" option and
  110.        no specified macros, the macro adapter cmn.pre doesn't get
  111.        included, and the width tables will be somewhat off.
  112.        Use "something | psroff -" instead of "something | psroff"
  113.        (This would also mean that ".fp"'s wouldn't work as well)
  114.     4) Apollo systems - contact me.  In short, COFF is not the
  115.        right answer.  Build psroff but don't install it with
  116.        HEADERSIZE 0.  Then run:
  117.         utils/dumpft -gv < /usr/lib/font/ftR | grep Guess
  118.        It will output a series of HEADERSIZE guesses plus an
  119.        error count.  Set the HEADERSIZE to the guess with the
  120.        minimum error count.  Rebuild psroff and the width tables
  121.        and install.
  122.     5) RISC/Ultrix troff has wierd width tables.  In fact, it can't
  123.        even use the ones that come with the Ultrix distribution!
  124.        Use ASCIIWIDTHS definition in defs.h.
  125.     6) widths/widthps/* won't go thru ditroff's makedev program.
  126.        Due to a minor syntax error in most of the width tables,
  127.        plus an incompatible DESC file.  Contact me if you need
  128.        the fixed ones (this does not affect CAT troff output!)
  129.     7) Widths for HP Laserjet III's are available - contact me if
  130.        you want them.
  131.     8) The FAX number on the test sheet is incorrect.  I'm no
  132.        longer at that address, and mail forwarding of FAXes is
  133.        too slow.  Patch 7 was supposed to fix it, but it broke.
  134.        If you want to send me test sheets, send them to:
  135.         C. Lewis, Box 13215, Kanata PO,
  136.         Kanata, Ontario, Canada K2K 1X4
  137.     
  138. And finally, because of the confusion between my psroff and
  139. Adobe's, I'm trying to come up with a better name for it - one
  140. that reflects what it really does.  I'm open to suggestions!
  141.