Annotation of 43BSD/contrib/dipress/doc/install.me, revision 1.1.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.