Annotation of 43BSD/contrib/dipress/doc/install.me, revision 1.1

1.1     ! root        1: .bp
        !             2: .sh 1 "Installing the Interpress Toolkit"
        !             3: .lp
        !             4: The initial installation of the software is accomplished by positioning to
        !             5: the top level directory and issuing a ``make all''.  This will
        !             6: create the Interpress run time library and various executables in the
        !             7: appropriate lib and bin subdirectories.  A subsequent ``make install'' will
        !             8: copy the relevant parts of the toolkit (executables, manual pages, font
        !             9: libraries, include files and run time library) to the appropriate local
        !            10: directories for convenient use (currently /usr/new/...). If local 
        !            11: requirements dictate that a different directory be used, the Makefile can be
        !            12: modified accordingly. 
        !            13: .lp
        !            14: Doing a ``make clean'' at the top level
        !            15: will remove all the object files and executables
        !            16: from this sub-tree.
        !            17: .sh 2 "Installing \*(TR"
        !            18: .sh 3 "Installing the Fonts"
        !            19: .lp
        !            20: In addition to the host-based \*(IP-\*(TR system, there are new fonts
        !            21: (TroffClassic and TroffMath) for the Xerox 8044 printer.
        !            22: This was necessitated for the following reasons:
        !            23: .ba +5
        !            24: .ip "\(bu"
        !            25: Many existing \*(TR documents were created for the C/A/T phototypesetter
        !            26: and use its many point sizes.
        !            27: .ip "\(bu"
        !            28: The Eqn preprocessor requires many special symbols,
        !            29: like the bracket building characters, which had to be specially created.
        !            30: .ip "\(bu"
        !            31: In the commercial Xerox fonts, some characters do not exist in all point sizes.
        !            32: .ba -5
        !            33: .lp
        !            34: To use the Troff system, install the Troff fonts (the five (5) floppies
        !            35: included in the distribution) on your 8044 printer.
        !            36: These fonts include the following point sizes: 6-14, 16, 18, 20, 22, 24,
        !            37: 28, 30, 32 and 36.
        !            38: If the floppies were not included in the distribution, they can be obtained 
        !            39: from Xerox by writing to the address in Appendix I.
        !            40: .lp
        !            41: To install the fonts on your printer, login on the printer with a system
        !            42: administrators account and issue the ``enable'' command.
        !            43: Then type on the console: ``Stop Printing''.
        !            44: Insert the first floppy
        !            45: (order doesn't matter), then type ``Install From Floppy''.  Answer ``Yes'' to
        !            46: all questions.  Continue to insert and install the rest of the floppies.  When
        !            47: done, type ``Start Printing'' and wait while a new font catalog is compiled.
        !            48: .sh 3 "Installing the Host Software"
        !            49: .lp
        !            50: We use the Multiple Device Queuing System (MDQS) software package
        !            51: from BRL-VGR.arpa to spool to our printers.  The programs ``maha'' and
        !            52: ``dipress'' both exec the program ``qip'' to enqueue an Interpress master.
        !            53: You may want to use the shell script ./src/bin/qip as a model to work from.
        !            54: Comments in that file detail what options qip is called with. 
        !            55: .lp
        !            56: The top level makefile has a variable at the front whose value
        !            57: is the location of your TI-Troff executable.  You should examine
        !            58: it for correctness in your environment.
        !            59: .lp
        !            60: Font metrics for TI-Troff are created from an Interpress metric master(s).
        !            61: The conf.troff directory is set-up to install the TroffClassic family.
        !            62: If you have metrics for other fonts on your printer, you will want
        !            63: to copy them into that directory and modify the makefile to use them.
        !            64: Ipmetrics will create a shell script that wants to execute the program
        !            65: ``makedev''.  This program comes with TI-Troff and you will want 
        !            66: it in your search path.
        !            67: See the manual page for ipmetrics for more information on this topic.
        !            68: .lp
        !            69: Should you want to use a pre-System V, Rel. 2 TI-Troff, note that the format
        !            70: of the font file changed slightly (but incompatibly) between releases.  If
        !            71: you have an older TI-\*(TR, change the size of the array ``intname'' (internal
        !            72: name) in dev.h from 21 to 10.
        !            73: .lp
        !            74: In the TI-Troff world, pre-processors know certain information about
        !            75: the output devices.  These pre-processors
        !            76: .i must
        !            77: be modified if correct output is to be produced.  Files processed with
        !            78: the default device type look squeezed together.
        !            79: You will have to edit programs like eqn and pic
        !            80: to know about ``-Tip'' or ``-Tipress''.  The minimum point size of our
        !            81: current release is 6 pt. and the \*(IP masters have a grid
        !            82: resolution of 2540 units per inch (ten microns).
        !            83: Below are differences from our System V,
        !            84: release 2 sources for eqn, pic and tbl:
        !            85: .(b
        !            86: .(l
        !            87: EQN/e.h:
        !            88:        33a39
        !            89:        > #define DEVIPRESS     7       /* Xerox Interpress */
        !            90: 
        !            91: EQN/io.h:
        !            92:        177a183,185
        !            93:        >                       else if (strncmp(&svargv[1][2], "ipress", 6) == 0  ||
        !            94:        >                                strncmp(&svargv[1][2], "ip", 2) == 0)
        !            95:        >                               {res = 2540; minsize = 6; ttype = DEVIPRESS; }
        !            96: EQN/sqrt.c:
        !            97:        9c9
        !            98:        <       if (ttype == DEVCAT || ttype == DEVAPS)
        !            99:        ---
        !           100:        >       if (ttype == DEVCAT || ttype == DEVAPS  ||  ttype == DEVIPRESS)
        !           101: 
        !           102: PIC/pic.h
        !           103:        26a27
        !           104:        > #define DEVIPRESS     7       /* Xerox Interpress */
        !           105: 
        !           106: PIC/main.c
        !           107:        103a108,112
        !           108:        >                       } else if (strncmp(&argv[1][2], "ipress", 6) == 0  ||
        !           109:        >                                  strncmp(&argv[1][2], "ip", 2)) {
        !           110:        >                               res = 2540;
        !           111:        >                               devtype = DEVIPRESS;
        !           112:        >                               DX = DY = 1;
        !           113: .)l
        !           114: .)b

unix.superglobalmegacorp.com

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