[BACK]Return to README CVS log [TXT] [DIR] Up to [Research Unix] / researchv10no / cmd / postscript

Annotation of researchv10no/cmd/postscript/README, revision 1.1

1.1     ! root        1: 
        !             2: Version 3.3 PostScript printer support programs. The package is now
        !             3: included as part of the DWB package. The instructions in this file
        !             4: ONLY apply if the PostScript support package has been separated from
        !             5: the DWB package.
        !             6: 
        !             7: -------------
        !             8: Major Changes
        !             9: -------------
        !            10: 
        !            11: In what follows TARGETS, BINDIR, and POSTBIN refer to definitions made
        !            12: in the top level makefile (file postscript.mk). All are described in the
        !            13: next section. The important changes are:
        !            14: 
        !            15:  1: dpost now reads ASCII font tables. makedev and the old binary font
        !            16:     tables are completely gone.
        !            17: 
        !            18:  2: The default PostScript font tables (directory postscript/devpost)
        !            19:     now only include the standard 35 fonts available on most PostScript
        !            20:     printers. All width tables were built on a version 47.0 QMS PS-810
        !            21:     using files in postscript/buildtables.
        !            22: 
        !            23:  3: Additional tables (the ones that were in the devpost collection
        !            24:     in DWB 3.0) have been moved to directory postscript/devpost.add.
        !            25:     By default they are not installed. If you need these tables include
        !            26:     devpost.add in the TARGETS list in file postscript.mk.
        !            27: 
        !            28:     If you're not already using the extra font tables don't start now.
        !            29:     Font names are poorly chosen, particularly since the .fp request
        !            30:     can now handle long font names (as synonyms). The devpost.add
        !            31:     tables are completely unsupported. There is no guarantee these
        !            32:     tables will be included in future releases.
        !            33: 
        !            34:  4: The original collection of PostScript font tables are supplied
        !            35:     (directory devopost), but by default are not installed. If you need
        !            36:     the tables add devopost to the TARGETS list in file postscript.mk.
        !            37: 
        !            38:     If you're not already using the old PostScript font tables don't
        !            39:     start now. The devopost tables are unsupported and will likely not
        !            40:     be included in future releases.
        !            41: 
        !            42:  5: dpost recognizes two new fields in the ASCII font tables. An entry
        !            43:     that begins with fontname, as in
        !            44: 
        !            45:                fontname Times-Roman
        !            46: 
        !            47:     is expected to be the full PostScript font name. All PostScript font
        !            48:     tables should include a fontname entry. The second entry is,
        !            49: 
        !            50:                named in prologue
        !            51: 
        !            52:     and is used to disable runtime abbreviation of font names - dpost
        !            53:     assumes the abbreviation is already in the prologue (file dpost.ps).
        !            54: 
        !            55:  6: All traces of the Varitimes font tables (VR, VI, VB, and VX) have
        !            56:     been removed.
        !            57: 
        !            58:  7: Bracket building problems on have been fixed by adding a Metrics
        !            59:     entry for braceleftbt to dpost.ps. Compensates for an apparent
        !            60:     mistake in Adobe's Symbol font.
        !            61: 
        !            62:  8: Translators (e.g. dpost, postprint) no longer leave save objects on
        !            63:     the operand stack. New and old versions of the translators and
        !            64:     prologues should not be mixed.
        !            65: 
        !            66:  9: Passing output from new translators through an old version of
        !            67:     postreverse may fail if the more than one page image is being
        !            68:     printed on each sheet of paper. The new version of postreverse
        !            69:     is safe and probably should be installed on all your systems,
        !            70:     even if you don't install any other part of the package.
        !            71: 
        !            72: 10: dpost and picpack are now only installed in directory BINDIR. The
        !            73:     makefiles,
        !            74: 
        !            75:                postscript/dpost/dpost.mk
        !            76:                postscript/picpack/picpack.mk
        !            77: 
        !            78:     delete dpost and picpack from POSTBIN before installing the new
        !            79:     versions. Change the two makefiles if you expect to find dpost
        !            80:     and picpack in directory POSTBIN.
        !            81: 
        !            82: 11: The mechanism for compiling DKHOST code in postio on internal
        !            83:     System V machines has been changed. The only way to get it is to
        !            84:     set DKHOST to TRUE in postscript.mk. Makefiles now assume dk.h and
        !            85:     libdk.a are in standard places (i.e. /usr/include and /usr/lib).
        !            86:     If that's not the case on your system you may have to edit file
        !            87:     postio/postio.mk.
        !            88: 
        !            89: 12: Man pages and programs are installed together - there's no easy
        !            90:     way to avoid it. Setting MAN1DIR and MAN5DIR to some existing
        !            91:     temporary directory (e.g. /tmp) means programs will be properly
        !            92:     installed but man pages won't go anywhere permanent.
        !            93: 
        !            94: Check the VERSION file for additional changes.
        !            95: 
        !            96: -------------------
        !            97: Tuning The Makefile
        !            98: -------------------
        !            99: 
        !           100: Source files, man pages, and low level makefiles can all be updated
        !           101: to reflect settings in postscript.mk in one simple step (described
        !           102: later). In most cases you only need to edit file postscript.mk.
        !           103: 
        !           104: First save a copy of file postscript.mk. Then adjust the following
        !           105: definitions in file postscript.mk:
        !           106: 
        !           107:   SYSTEM    best match for your version of Unix. Current choices for
        !           108:            SYSTEM are:
        !           109: 
        !           110:                        SYSV    - System V
        !           111:                        V9      - Ninth Edition
        !           112:                        BSD4_2  - Berkeley (eg. Sun)
        !           113: 
        !           114:            Controls conditional compilation in a few places.
        !           115: 
        !           116:   GROUP            group assigned to all installed files
        !           117: 
        !           118:   OWNER            owner of everything that's installed
        !           119: 
        !           120:   BINDIR    dpost and picpack go here. All other programs go in POSTBIN.
        !           121:            BINDIR must already exist - it will not be created during an
        !           122:            install.
        !           123: 
        !           124:   HOSTDIR   hostresident font directory for PostScript printers. Only
        !           125:            used in the font download program.
        !           126: 
        !           127:   FONTDIR   width table directory - for troff and most postprocessors
        !           128: 
        !           129:   MAN1DIR   command manpages. A command and its manpage are installed
        !           130:            together - there's no easy way to avoid it. Setting MAN1DIR
        !           131:            to an existing temporary directory (e.g. /tmp) means an
        !           132:            install will work but manpages won't go anywhere permanent.
        !           133:            MAN1DIR must already exist - it will not be created during
        !           134:            an install.
        !           135: 
        !           136:   POSTBIN   where most PostScript support programs go. dpost and picpack
        !           137:            the exceptions.
        !           138: 
        !           139:   POSTLIB   prologues and miscellaneous PostScript files. Primarily for
        !           140:            the programs that live in POSTBIN.
        !           141: 
        !           142:   CFLGS            common compiler options - used to build CFLAGS in the low
        !           143:            level makefiles. CLFGS and LDFLGS are best set on the make
        !           144:            command line.
        !           145: 
        !           146:   LDFLGS    common link editor options - used to build LDFLAGS in the
        !           147:            low level makefiles. LDFLGS and CFLGS are best set on the
        !           148:            make command line.
        !           149: 
        !           150:   DKHOST    must only be set to TRUE or FALSE. TRUE means compile DKHOST
        !           151:            Datakit support code in postio. Only used if SYSTEM is SYSV.
        !           152: 
        !           153:   DOROUND   must only be set to TRUE or FALSE. TRUE means PostScript
        !           154:            translators include code that maps clipping path dimensions
        !           155:            into known paper sizes.
        !           156: 
        !           157:   TARGETS   the default list of what's built by make. Each target must
        !           158:            be the name of a source directory. A target that names a
        !           159:            non-existent source directory is ignored. Setting TARGETS
        !           160:            on the make command line overrides the default list.
        !           161: 
        !           162: -------------------
        !           163: Updating The Source
        !           164: -------------------
        !           165: 
        !           166: Whenever file postscript.mk changes you should update source files,
        !           167: man pages, and low level makefiles by typing,
        !           168: 
        !           169:        make -f postscript.mk changes
        !           170: 
        !           171: ------------------------
        !           172: More System Dependencies
        !           173: ------------------------
        !           174: 
        !           175: The package has been compiled and tested on System V and Ninth Edition
        !           176: Unix Systems and on Sun workstations. Most differences are handled via
        !           177: the SYSTEM definition in postscript.mk. Problems that remain are:
        !           178: 
        !           179:   SYSV - System V
        !           180:     Use the native compiler if you're on an internal System V UTS
        !           181:     machine.
        !           182: 
        !           183:   V9 - Ninth or Tenth Edition
        !           184:     chown is in /etc and chgrp no longer exists - it's been folded into
        !           185:     the chown command. You may be forced to build a simple chgrp shell
        !           186:     script (put it in your bin) that calls chown. If you're not superuser
        !           187:     set OWNER to your login name and GROUP to your group id.
        !           188: 
        !           189:   BSD4_2 - Sun Workstations
        !           190:     Use the Bourne shell. chown is should be in /usr/etc. Add /usr/etc
        !           191:     to your PATH and export PATH. If you're not superuser set OWNER to
        !           192:     your login name and GROUP to your group id.
        !           193: 
        !           194: ----------------------
        !           195: Installing The Package
        !           196: ----------------------
        !           197: 
        !           198: To build (but not install) the default package (i.e. everything named by
        !           199: TARGETS in postscript.mk) type,
        !           200: 
        !           201:        make -f postscript.mk all
        !           202: 
        !           203: To build and install the package type,
        !           204: 
        !           205:        make -f postscript.mk all install
        !           206: 
        !           207: After the package is installed use,
        !           208: 
        !           209:        make -f postscript.mk clobber
        !           210: 
        !           211: to delete binary files and compiled programs from the source directories.
        !           212: 
        !           213: To select part of the package define TARGETS on the command line. For
        !           214: example,
        !           215: 
        !           216:        make -f postscript.mk TARGETS="dpost devpost" all install
        !           217: 
        !           218: builds and installs dpost and the PostScript font tables. Quotes hide
        !           219: white space from the shell.
        !           220: 
unix.superglobalmegacorp.com

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