Annotation of 43BSDTahoe/new/dipress/doc/intro.me, revision 1.1.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: 

unix.superglobalmegacorp.com

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