Annotation of 43BSDTahoe/new/dipress/doc/install-unix.me, revision 1.1.1.1

1.1       root        1: .bp
                      2: .sh 1 "Installing the Interpress Toolkit on Unix"
                      3: .lp
                      4: The initial installation of the \*(IP toolkit
                      5: is accomplished by positioning to
                      6: the top level directory and issuing a ``make all''.  This
                      7: creates the Interpress run time library and various executables in the
                      8: appropriate lib and bin subdirectories.  A subsequent ``make install'' will
                      9: copy the relevant parts of the toolkit (executables, manual pages, font
                     10: libraries, include files and run time library) to the appropriate local
                     11: directories for convenient use (currently /usr/new/...). If local 
                     12: requirements dictate that a different directory be used, the Makefile can be
                     13: modified accordingly. 
                     14: .lp
                     15: Doing a ``make clean'' at the top level
                     16: will remove all the object files and executables
                     17: from this sub-tree.
                     18: .sh 2 "Installing Support For \*(TR"
                     19: .lp
                     20: This package only works with Typesetter-Independent \*(TR.  Most Unix
                     21: systems are distributed with a \*(TR for the Graphics Systems C/A/T-4
                     22: phototypesetter.  Typesetter-Independent \*(TR is available from
                     23: AT&T either seperately or as part of the Documentor's Workbench.
                     24: .lp
                     25: At this writing, all development and testing has occured on Xerox 8044s.
                     26: More to the point, the 8044 is the only printer for which the \*(TR
                     27: fonts are supplied.
                     28: On the other hand, there are no known limitiations that
                     29: might prevent this package from working on other printers.
                     30: .sh 3 "Installing the Fonts on Your Printer"
                     31: .lp
                     32: Special \*(TR fonts have been developed for use with this package.
                     33: While the product font ``Classic'' was used in earlier releases, it
                     34: was decided to create new fonts for the following reasons:
                     35: .ba +5
                     36: .ip "\(bu"
                     37: Many existing \*(TR documents were created for the C/A/T phototypesetter
                     38: and use its many point sizes.
                     39: .ip "\(bu"
                     40: The Eqn preprocessor requires many special symbols,
                     41: like the bracket building characters, which had to be specially created.
                     42: .ip "\(bu"
                     43: In the commercial Xerox fonts, some characters do not exist in all point sizes.
                     44: .ba -5
                     45: .lp
                     46: The Troff fonts are distributed on five (5) floppies.
                     47: If the floppies were not included in the distribution, they can be obtained 
                     48: from Xerox by writing to the address in Appendix I.
                     49: These fonts include the point sizes: 6-14, 16, 18, 20, 22, 24,
                     50: 28, 30, 32 and 36.
                     51: .lp
                     52: To install the fonts on your printer, login on the printer with a system
                     53: administrator's account and issue the ``enable'' command.
                     54: Then type on the console: ``Stop Printing''.
                     55: Insert the first floppy
                     56: (order doesn't matter), then type ``Install From Floppy''.  Answer ``Yes'' to
                     57: all questions.  Continue to insert and install the rest of the floppies.  When
                     58: done, type ``Start Printing'' and wait while a new font catalog is compiled.
                     59: .sh 3 "Installing the Host Software"
                     60: .lp
                     61: We use the Multiple Device Queuing System (MDQS) software package
                     62: from BRL-VGR.arpa to spool to our printers.  The programs ``maha'' and
                     63: ``dipress'' both exec the program ``qip'' to enqueue an Interpress master.
                     64: You may want to use the shell script ./src/bin/qip as a model to work from.
                     65: Comments in that file detail what options qip is called with. 
                     66: .lp
                     67: The top level makefile has a variable at the front whose value
                     68: is the location of your TI-Troff executable.  You should examine
                     69: it for correctness in your environment.
                     70: .lp
                     71: Font metrics are information about fonts rather than the character
                     72: representations themselves.  The most commonly needed information
                     73: is a character's width.  In this distribution,
                     74: font metrics for TI-Troff are created from an Interpress metric master(s).
                     75: The conf/troff directory is set-up to install metrics for the following
                     76: font families: TroffClassic, (product) Classic, Modern, Terminal and Titan.
                     77: If you have metrics for other fonts on your printer,
                     78: copy them into conf/troff and modify the makefile to use them.
                     79: Ipmetrics will create a shell script that wants to execute the program
                     80: ``makedev''.  This program comes with TI-Troff and you will want 
                     81: it in your search path.
                     82: See the manual page for ipmetrics for more information on this topic.
                     83: .lp
                     84: Should you want to use a pre-System V, Rel. 2 TI-Troff, note that the format
                     85: of the font file changed slightly (but incompatibly) between releases.  If
                     86: you have an older TI-\*(TR, change the size of the array ``intname'' (internal
                     87: name) in dev.h from 21 to 10.
                     88: .lp
                     89: In the TI-Troff world, pre-processors know certain information about
                     90: the output devices.  These pre-processors
                     91: .i must
                     92: be modified if correct output is to be produced.  Files processed with
                     93: the default device type look squeezed together.
                     94: You will have to edit programs like eqn and pic
                     95: to know about ``-Tip'' or ``-Tipress''.  The minimum point size of our
                     96: current release is 6 pt. and the \*(IP masters have a grid
                     97: resolution of 2540 units per inch (ten microns).
                     98: Below are differences from our System V,
                     99: release 2 sources for eqn, pic and tbl:
                    100: .(b L
                    101: .nf
                    102: EQN/e.h:
                    103:        33a39
                    104:        > #define DEVIPRESS     7       /* Xerox Interpress */
                    105: 
                    106: EQN/io.h:
                    107:        177a183,185
                    108:        >                       else if (strncmp(&svargv[1][2], "ip", 2) == 0 )
                    109:        >                               {res = 2540; minsize = 6; ttype = DEVIPRESS; }
                    110: EQN/sqrt.c:
                    111:        9c9
                    112:        <       if (ttype == DEVCAT || ttype == DEVAPS)
                    113:        ---
                    114:        >       if (ttype == DEVCAT || ttype == DEVAPS  ||  ttype == DEVIPRESS)
                    115: 
                    116: PIC/pic.h
                    117:        26a27
                    118:        > #define DEVIPRESS     7       /* Xerox Interpress */
                    119: 
                    120: PIC/main.c
                    121:        103a108,112
                    122:        >                       } else if (strncmp(&argv[1][2], "ip", 2) == 0 ) {
                    123:        >                               res = 2540;
                    124:        >                               devtype = DEVIPRESS;
                    125:        >                               DX = DY = 1;
                    126: .)b
                    127: .lp
                    128: TI-\*(TR itself has a bug where it won't always correctly parse font numbers
                    129: in it's input if there are more than nine fonts.  The basic error
                    130: occurs on lines of the  form:
                    131: .(l I
                    132: \f(TRif ((k = i - '0') >= 0 && k <= nfonts && k < smnt)
                    133:        return(k)
                    134: .)l
                    135: In this example (taken from t6.c), ``i'' represents the font name right
                    136: justified and zero filled.  In \*(TR, fonts can be named by their name
                    137: or by their position number.  The above test trys to see if the value
                    138: of ``i'' is a position number and if so, return the integer value of that
                    139: number.  But note that the ASCII to binary conversion only works for
                    140: one digit position numbers.  If the position is greater than ten, then
                    141: the test will fail.

unix.superglobalmegacorp.com

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