Return to intro.me CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / dipress / doc

Annotation of 43BSDTahoe/new/dipress/doc/intro.me, revision 1.1

1.1     ! root        1: .eh '%'Interpress Toolkit''
        !             2: .oh ''Interpress Toolkit'%'
        !             3: .sh 1 Overview
        !             4: .sh 2 "What is \*(IP?"
        !             5: .lp
        !             6: To describe \*(IP, we choose to quote from the preface of ``Introduction
        !             7: to Interpress'' (see Appendix \f(RN1\fP for a bibilography):
        !             8: .(q
        !             9: The \*(IP standard defines the digital representation of printed
        !            10: material for exchange between a creator and a printer.  A document
        !            11: represented in Interpress can be transmitted to a raster printer or other
        !            12: display device for printing, it can be transmitted across a communication
        !            13: network as a means of exchanging graphic information, or it can be stored
        !            14: as an archival master copy of the material.  A document in \*(IP
        !            15: is not limited to any particular printing device; it can be printed
        !            16: on any sufficiently powerful printer that is equiped with \*(IP
        !            17: print software.
        !            18: .)q
        !            19: .sh 2 "What is in this distribution?"
        !            20: .lp
        !            21: The \*(IP Toolkit provides ``C'' language code
        !            22: for the creation and manipulation of \*(IP files.
        !            23: The package consists of:
        !            24: .RS
        !            25:        ``C'' source files which define useful constants
        !            26: .br
        !            27:        a library of subroutines
        !            28: .br
        !            29:        executable utilities
        !            30: .br
        !            31:        documentation
        !            32: .RE
        !            33: Items one and two aid programmers in writing new application code.
        !            34: .lp
        !            35: A attempt has been made to keep the code portable.  While
        !            36: development has occured under 4.3BSD Vax Unix, portions of this package
        !            37: also run on Masscomp Unix, Vax/VMS, and IBM PC-DOS operating systems.
        !            38: .lp
        !            39: The executable utilities mainly transform files to and/or from \*(IP.
        !            40: Below is a quick summary of the names of the programs and their function:
        !            41: .RS
        !            42: .ip "maha"
        !            43: treats the laser printer as a line-printer.
        !            44: Normally, it uses a fixed-width font so that columns will line up.
        !            45: Options are provided to change the font, provide two-column output,
        !            46: and print landscape (rotated) output.
        !            47: .ip "dipress\(dg"
        !            48: .(f
        !            49: \(dg Unix only
        !            50: .)f
        !            51: post-processes the output from typesetter-independent \*(TR
        !            52: and creates from it an \*(IP master.
        !            53: .ip "iptroff\(dg"
        !            54: A shell script which will call typesetter-independent \*(TR and then
        !            55: ``dipress''.
        !            56: .ip "ipfe"
        !            57: An editor to extract, modify and combine pages from \*(IP files.
        !            58: .ip "ipmetrics"
        !            59: converts fonts metrics from the \*(IP metric master format
        !            60: to that of specific composing systems.
        !            61: .ip "plot2ip\(dg"
        !            62: converts Unix plot(5) format to \*(IP.
        !            63: .ip "iptotext"
        !            64: \*(IP files are encoded in binary.
        !            65: We have created a parallel ASCII representation to \*(IP to aid in
        !            66: reading \*(IP masters.  Since the mapping is one-to-one, \*(IP files
        !            67: can be converted back & forth from binary to ASCII
        !            68: without loss of information.
        !            69: The ASCII syntax is documented in Section 5 of this document.
        !            70: 
        !            71: The programs iptotext and texttoip convert between these two representations
        !            72: in the obvious way.  Converting to text is a handy way to debug
        !            73: \*(IP files that are constructed using the C language interface described
        !            74: in Section 4.  A text representation also provides a way for knowledgable people
        !            75: to edit \*(IP files.  For example, it was used to debug \*(TR changes
        !            76: to remove the cut-marks inserted by the standard 4.2BSD macros.
        !            77: .ip "texttoip"
        !            78: reverses the above transformation.
        !            79: .ip "charset"
        !            80: .EQ
        !            81: delim $$
        !            82: .EN
        !            83: This program creates an \*(IP master of a 
        !            84: .i "character set"
        !            85: of a specific font in a given point
        !            86: size in tabular form.  The Xerox Character Encoding Standard currently specifies
        !            87: characters for a range of [0..$2 sup 16 - 1$] values.
        !            88: This space is divided into 256 character sets.
        !            89: Since this space is rather sparse, it's handy to know exactly which
        !            90: characters your printer can print.  See appendix \f(RN1\fP for a reference
        !            91: to the Character Code Standard.
        !            92: .EQ
        !            93: delim off
        !            94: .EN
        !            95: .ip "mp2res, restotext and stackres"
        !            96: Xerox's Raster Encoding Standard (RES) is used to transmit
        !            97: and exchange image data.  The program ``mp2res'' converts a
        !            98: MacPaint file to RES format.  ``restotext'' converts an RES file
        !            99: to a textual representation in a manner similar to iptotext.  ``stackres''
        !           100: executes the RES file (an RES file is similar to an \*(IP file) and
        !           101: prints out what is left on the stack.
        !           102: .RE
        !           103: .sh 2 "What is not in this distribution?"
        !           104: .lp
        !           105: The code provided in this distribution only creates \*(IP masters.
        !           106: Functions such as communicating the master to a printer are beyond
        !           107: the scope of this package.
        !           108: .lp
        !           109: For users of 4.3BSD Unix, XNS communications protocols are provided
        !           110: on the standard tape.  For users of VMS, a Xerox software product called
        !           111: ``XNS/DEC VAX'' is available.  For users of the PCs, there is a package
        !           112: offered by Xerox and 3Com called ``XNS/IBM PC''.  This list is not
        !           113: exhaustive as we have heard of (but not used) other implementations.
        !           114: 
        !           115: 

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