Return to install-unix.me CVS log

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

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

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