Annotation of researchv10dc/cmd/postscript/VERSION, revision 1.1.1.1

1.1       root        1: ------------------------
                      2: Version 3.3.1   5/20/91
                      3: ------------------------
                      4: 
                      5:  1: buildtables stuff has been cleaned up and is now a user level command.
                      6:     Uses shell.lib files that are installed with font tables. The devpost
                      7:     tables were built on a version 47.0 PS-810. The devLatin1 tables were
                      8:     built on a version 51.7 PS-820.
                      9: 
                     10:  2: The devLatin1 tables provide support for the ISO Latin1 alphabet on
                     11:     PostScript printers.
                     12: 
                     13:  3: All translators support different text font encoding schemes using the
                     14:     -E option and *.enc files installed in POSTLIB. The ISO Latin 1 alphabet
                     15:     is supported with file /usr/lib/postscript/Latin1.enc.
                     16: 
                     17:  4: printfont prints a table of the available (encoded) characters in one
                     18:     or more PostScript fonts. It also understands the -E option.
                     19: 
                     20:  5: grabit and hardcopy are two new programs that may be of interest to the
                     21:     more serious PostScript programmer. grabit resembles ==, but produces
                     22:     output that's usally easier to read. hardcopy redirects output from
                     23:     PostScript file output operators (or procedures) to paper. It's useful
                     24:     if you don't have direct access to a printer.
                     25: 
                     26:  6: Prologues and programs are stored together. Other common PostScript files
                     27:     are now in the psfiles directory.
                     28: 
                     29:  7: Changed $(@F) in the DWB 3.2 makefiles to `basename $@`. $(@F) didn't work
                     30:     properly on research systems??
                     31: 
                     32: ------------------------
                     33: Verions 3.3    4/16/90
                     34: ------------------------
                     35: 
                     36:  1: The package is now included in DWB. Version numbers are a bit misleading.
                     37:     The one in postscript.mk refers to the DWB package.
                     38: 
                     39:  2: dpost (and troff) now read ASCII font tables. makedev and the old binary
                     40:     format are gone.
                     41: 
                     42:  3: The devpost directory came directly from the DWB package. The font tables
                     43:     originally distributed with this package are in directory devopost. They
                     44:     are not installed. If possible we recommend you use the devpost tables.
                     45:     The old tables can be installed by adding devopost to the TARGETS list in
                     46:     file postscript.mk.
                     47: 
                     48:  4: dpost recognizes two new fields in font tables. Entries for the full
                     49:     PostScript font look like,
                     50: 
                     51:                fontname Times-Roman
                     52: 
                     53:     The fontname field is helps manage host resident fonts, the DocumentFonts
                     54:     comment, and is used to define font name abbreviations like the ones in
                     55:     dpost.ps. A font table entry that looks like,
                     56: 
                     57:                named in prologue
                     58: 
                     59:     disables the runtime abbreviation for the font - dpost assumes it's already
                     60:     in the prologue.
                     61: 
                     62:  5: Extra font tables included in DWB 3.0's devpost font collection are in
                     63:     directory devpost.add. They included here, but should probably not be
                     64:     used.
                     65: 
                     66:  6: Bracket building has been fixed and tested on a wide range of PostScript
                     67:     printers. It will likely still not work on many clones. Real problem
                     68:     appears to be with Adobe's braceleftbt character.
                     69: 
                     70:  7: Most of the special tuning code for device emulation has been removed.
                     71:     Emulation still works, but there may be cases where it's not as good as
                     72:     earlier versions.
                     73: 
                     74:  8: Several problems with color and reverse video printing have been fixed.
                     75: 
                     76:  9: buildtables directory has been cleanup up. The template files in directory
                     77:     buildtables/devpost.data were used to build the devpost tables.
                     78: 
                     79: 10: postplot and download are two new programs. postplot is for the System V
                     80:     plot package only. Both were written for the Unix 4.0 lp package.
                     81: 
                     82: 11: postgif is also relatively new - it came from Chi Choy.
                     83: 
                     84: 12: The translators now rotate clockwise when printing in landscape mode. If
                     85:     you want the old behavior set ROTATION to -1 in postscript.mk.
                     86: 
                     87: 13: forms.ps has been cleaned up some. Better behavior when you print 2
                     88:     landscape pages on one sheet.
                     89: 
                     90: 14: Handling of Datakit code for System V has been changed some. Makefiles
                     91:     now expect to find libdk.a and dk.h in standard places (e.g /usr/lib and
                     92:     /usr/include). Set DKHOST to TRUE in postscript.mk to get Datakit support
                     93:     on System V.
                     94: 
                     95:     If you're stuck and need to have things behave as they did in the past
                     96:     take a look at file postio/postio.mk. Define DKHOSTDIR and uncomment
                     97:     three lines and the behavior should be close to what it was.
                     98: 
                     99: 15: Picture inclusion and color macros are gone. They're included in the DWB
                    100:     package, and not here.
                    101: 
                    102: ------------------------
                    103: Version 3.2    11/27/89
                    104: ------------------------
                    105: 
                    106:  1: Implemented height and slant requests in dpost.
                    107: 
                    108:  2: Modified the behavior of all translators so save objects are no longer left
                    109:     on the stack. The original implementation was a mistake and occasionally
                    110:     (e.g. picture inclusion with forms.ps) resulted in invalid restores.
                    111: 
                    112:  3: Fixed the mistake in the external declaration of mesg in postio/slowsend.c.
                    113: 
                    114:  4: The malloc() call in postdmd (routine dimensions()) is only made if patterns
                    115:     is positive.
                    116: 
                    117:  5: Changed definition of De in draw.ps so savematrix is loaded with the CTM
                    118:     whenever De is executed. Original implementation didn't work with forms.ps
                    119:     because the CTM is changed with each page image. (4/29/89)
                    120: 
                    121:  6: Flush stdout when postio is invoked with the -t option - just convenient
                    122:     not necessary. (4/30/89)
                    123: 
                    124:  7: Included a man page for the picture inclusion macros - file man/mpictures.5.
                    125:     (5/6/89)
                    126: 
                    127:  8: Added BoundingBox code to dpost - still needs to go in other translators.
                    128:     Most of the work is done in common/bbox.c. (5/7/89)
                    129: 
                    130:  9: Fiddled with the bracket building stuff in dpost.ps so things finally look
                    131:     decent. Was particularly bad on the typesetter.
                    132: 
                    133: 10: dpost now generates a PageBoundingBox comment and ps_include.c accepts
                    134:     the comment. Added -B option to enable/disable the BoundingBox calculations.
                    135:     -Bon to enable and -Boff to disable. On by default now, but that may change.
                    136:     Add similar code to the rest of the translators (6/20/89).
                    137: 
                    138: 11: Fixed ps_include.c so it properly handles %%BeginGlobal and %%EndGlobal.
                    139:     Added braces and compare page.start to page.end instead of 0.
                    140: 
                    141: 12: Added xymove(hpos, vpos) for \X'PS ...' request - near the end of devcntrl().
                    142:     Must output position info for following PostScript.
                    143: 
                    144: 13: Added a call to endtext() immediately before the oput() call for \N'...'
                    145:     requests. Without it spacing often messed up with -e2 but not -e0.
                    146: 
                    147: ------------------------
                    148: Version 3.1    11/15/88
                    149: ------------------------
                    150: 
                    151:  1: postio can run as one or two processes (-R option) and can establish an
                    152:     interactive connection with a postscript printer (-i option). Parsing of
                    153:     status reports has been improved. The status query mechanism can be disabled
                    154:     using the -q option. An exit status of 1 implies a system error (eg. can't
                    155:     open the line) while 2 usually means there was an error in the PostScript
                    156:     file. By default postio runs as a single process. The -B, -R, and -q options
                    157:     can be used to speed things up some. A version of the program (previously
                    158:     supplied in postio.tmp) that can help if you seem to be having flow control
                    159:     problems can be obtained using the -S option. It's not generally recommended
                    160:     and should only be used as a last resort!
                    161: 
                    162:  2: Several widthshow encoding schemes have been added to dpost and can reduce
                    163:     print time by 20% or more. The method used to encode lines of text can be
                    164:     changed on the command line using the -e option. Level 0 produces output
                    165:     essentially identical to previous versions of dpost. The default can be
                    166:     changed by modifying the definition of ENCODING in ./Makefile. At present
                    167:     only level 0 is thoroughly tested, although level 2 (ie. -e2) may be the
                    168:     default and is undoubtedly worth a try.
                    169: 
                    170:  3: dpost now supports color selection and reverse video. Access in troff is via
                    171:     the stand-alone macro package ./macros/color. Examples are,
                    172: 
                    173:        .so /usr/lib/macros/color
                    174:        .CL red "this prints in red"
                    175:        .CL "white on black" "and this prints white text on a black background"
                    176: 
                    177:     The postscript procedures that handle color and reverse video can be found
                    178:     in ./postscript/color.ps. Additional colors can be added to the colordict
                    179:     dictionary defined in ./postscript/color.ps.
                    180: 
                    181:  4: The dpost drawing routines have been improved and have been moved from the
                    182:     prologue (ie. ./postscript/dpost.ps) to ./postscript/draw.ps. That file is
                    183:     only included if needed. Drawing routines now support the ability to group
                    184:     a series of drawing commands together as a single path. May be useful for
                    185:     future versions of pic that wish to fill regions with colors or gray levels.
                    186:     Access is via the new "x X BeginPath" and "x X DrawPath" device control
                    187:     commands. In addition there's some complicated PostScript code in file
                    188:     ./postscript/baseline.ps, that can be used to set text along an arbitrary
                    189:     curve. It's terribly confusing and I doubt anyone will have the patience to
                    190:     bother to figure it out.
                    191: 
                    192:  5: A simple picture packing troff preprocessor (picpack) has been included and
                    193:     the code needed to recover pictures and text has been added to dpost. The
                    194:     program is designed to supplement to the original picture inclusion mechanism,
                    195:     and should ONLY be used when absolutely necessary. Using dpost to pull picture
                    196:     files into a document is strongly recommended and will always be the more
                    197:     efficient and portable approach. picpack simply provides a way to combine
                    198:     pictures and text in a single file before dpost is executed. It may help in
                    199:     a distributed printing environment where the user runs everything through
                    200:     troff while a spooling daemon (eg. lp) handles the postprocessing. There
                    201:     are serious disadvantages to this approach, with perhaps the most important
                    202:     being that troff output files (when picpack is used) will likely result in
                    203:     files that can no longer be reliably passed through other important post-
                    204:     processors like proof.
                    205: 
                    206:  6: Code to handle host resident PostScript fonts in dpost has been tested and
                    207:     finally works. The -H option points dpost to a host resident font directory,
                    208:     which by default is NULL. Host resident font files stored in that directory
                    209:     must be assigned a name that corresponds to the one or two character troff
                    210:     font name. Width tables must also be built (see buildtables/README), the new
                    211:     binary font files must be installed in /usr/lib/font/devpost, and a mapping
                    212:     definition from troff's name to the PostScript font name must be added to
                    213:     ./postscript/dpost.ps.
                    214: 
                    215:  7: The default pattern length in postdmd has been reduced to from 10 to 6 bytes.
                    216:     Printers with fast processors (eg. PS-810s) often benefit from a further
                    217:     reduction, while optimal performance on slower printers (eg PS-800s) may
                    218:     require larger pattern sizes. The pattern length can be set using the -b
                    219:     option. Increasing the pattern size usually increases the size of the output
                    220:     file.
                    221: 
                    222:  8: Line drawing in posttek and postbgi includes code that automatically ties
                    223:     lines to device space coordinates when you select a non-zero width. Helps
                    224:     eliminate the variation in line thickness that many observed. The default
                    225:     line width in posttek and postbgi is still 0 (which gets 1 pixel). If you
                    226:     want a different default change the definition of variable linewidth in files
                    227:     ./postscript/posttek.ps and ./postscript/postbgi.ps.
                    228: 
                    229:  9: Defocused lines in posttek have been fixed.
                    230: 
                    231: 10: postbgi now supports color and can be used to translate most PRISM (color
                    232:     BGI) jobs. Special device specific tuning needed for many PRISM jobs can be
                    233:     enabled by using the -P"/prism true" option. Missing pieces (eg. subroutines)
                    234:     needed for translating PRISM jobs, have also been implemented.
                    235: 
                    236: 11: postreverse can reverse the pages in documents that conform to Adobe's 1.0
                    237:     or 2.0 file structuring conventions, and it works with all the translators in
                    238:     this package. The new version is backwards compatible, but files produced by
                    239:     the new translators should not be passed through old versions of postreverse.
                    240:     The likely result will be no output at all. If you choose to do a partial
                    241:     installation put the new postreverse up first!
                    242: 
                    243: 12: All translators attempt to conform to Adobe's Version 2.0 file structuring
                    244:     conventions. dpost output falls short, but only in the interest of efficiency.
                    245:     Passing dpost output through postreverse (perhaps with the -r option) produces
                    246:     a minimally conforming PostScript file.
                    247: 
                    248: 13: All the translators now support three options that pass arbitrary PostScript
                    249:     through to the output file. The -P and -C options add a string and the
                    250:     contents of a file respectively immediately after the prologue. It's assumed
                    251:     whatever is added is legitimate PostScript - there is no checking. In each
                    252:     case the added PostScript code becomes part of the job's global environment.
                    253: 
                    254:     The -R option can be used to request special action (eg. manualfeed) on a
                    255:     global or page basis.  The argument should be "request", "request:page", or
                    256:     "request:page:file". If page is given as 0 or omitted the request applies
                    257:     globally. If file is omitted the lookup is in /usr/lib/postscript/ps.requests.
                    258:     The collection of recognized requests can be modified or extended by changing
                    259:     /usr/lib/postscript/ps.requests.
                    260: 
                    261: 14: PostScript code (from Johnathan Shopiro) that produces bolder versions of the
                    262:     Courier fonts has been included in file postscript/fatcourier.ps. The file
                    263:     can  be added to individual prologue files (eg. dpost.ps) or pulled in as
                    264:     needed using the -C option.
                    265: 
                    266: 15: postmd is a new program that can be used to display a large matrix as a gray
                    267:     scale image. May help if you're looking for patterns in a large matrix. A very
                    268:     optimistic estimate suggests you can display up to a 600x600 matrix (with five
                    269:     different shades of gray) on 300dpi printer using 8.5x11 inch paper.
                    270: 
                    271: 16: What's available in buildtables has been cleaned up and works well with the
                    272:     new version of postio. It can be used to have PostScript printers build troff
                    273:     width tables for both printer and host resident fonts.
                    274: 
                    275: 17: The PostScript bind operator has been applied to all procedures that are
                    276:     expected to be executed more than once. Redefined save and restore procedures
                    277:     are no longer needed and saverestore.ps is not included in this package.
                    278: 
                    279: 18: The bizarre PostScript code used to get to the upper left corner of a page
                    280:     in old versions of dpost.ps and postprint.ps has been replaced by something
                    281:     that's at least slightly more comprehensible. All prologues have also been
                    282:     changed so picture inclusion (eg. including a pic picture that's been run
                    283:     through troff and dpost) should work better than previous versions. Still
                    284:     missing (from most translators) is the %%BoundingBox comment and even when
                    285:     it's put out (by postdmd) only the dimensions are correct - sorry!
                    286: 
                    287: 19: The careless mistake in the DKHOST section of postio that some noticed belongs
                    288:     to me (not Allan Buckwalter) and has now been fixed.
                    289: 
                    290: 20: By default all prologues still use the current clipping path to determine page
                    291:     dimensions, but that behavior can be disabled by setting boolean useclippath
                    292:     (in each prologue) to false. In that case the page dimensions will be taken
                    293:     from array pagebbox, which by default is initialized to 8x11 inch paper. The
                    294:     -P options (in each translator) can change useclippth and pagebbox.
                    295: 
                    296: 21: New in the misc directory is sample lp support from Maryann Csaszar and a
                    297:     simple program that converts host resident font files obtained from a Macintosh
                    298:     to a format that works on Unix.
                    299: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.