Return to setup_geo.nr CVS log

Up to [CSRG BSD Unix] / 43BSD / ingres / doc / other

Annotation of 43BSD/ingres/doc/other/setup_geo.nr, revision 1.1

1.1     ! root        1: .ds II \s-2INGRES\s0
        !             2: .ds GQ \s-2GEO-QUEL\s0
        !             3: .ds HE 'HOW TO SET UP GEO-QUEL''PAGE %'
        !             4: .so nmacs
        !             5: .ce
        !             6: Instructions for setting up GEO-QUEL version 6.2.
        !             7: 
        !             8: .ce
        !             9: (March 22, 1979)
        !            10: 
        !            11: This set of instructions will help you to get
        !            12: \*(GQ running on your \*(II system.
        !            13: If you have been running version 4.0 of \*(GQ
        !            14: you should be aware of some differences
        !            15: between the old and current versions.
        !            16: They are identified in section 6 of this document.
        !            17: Your \*(II system should have been completely
        !            18: installed before starting to install \*(GQ.
        !            19: 
        !            20: 
        !            21: .sh 1
        !            22: Moving \*(GQ to /usr/bin.
        !            23: .PS
        !            24: The binary for \*(GQ is in .../bin/geoquel.
        !            25: It should be moved or linked into /usr/bin.
        !            26: This will provide you with a working system.
        !            27: 
        !            28: Move \*(GQ to /usr/bin:
        !            29: 
        !            30: .ti +8
        !            31: mv .../bin/geoquel  /usr/bin/geoquel
        !            32: 
        !            33: Verify that the file mode of \*(GQ is 711.
        !            34: Notice that it SHOULD NOT set user id.
        !            35: The correct mode is:
        !            36: 
        !            37: .ti +8
        !            38: -rwx--x--x 1 ingres    . . .   geoquel
        !            39: .sh 1
        !            40: \*(GQ documentation.
        !            41: .PS
        !            42: The reference manual for \*(GQ may be found
        !            43: in .../doc/geoquel.
        !            44: To print a copy of the \*(GQ reference manual
        !            45: on the line printer,
        !            46: execute the command:
        !            47: 
        !            48: .ti +8
        !            49: setup georef | lpr
        !            50: 
        !            51: These instructions can be printed using the command:
        !            52: 
        !            53: .ti +8
        !            54: nroff .../doc/other/setup_geo.nr
        !            55: 
        !            56: Documentation for the graphic terminal support
        !            57: software, GRAFPAC, is currently limited to the information
        !            58: in the code.
        !            59: The files in .../geoquel/grafpac are organized such that a
        !            60: file names start with a descriptive two letter code.
        !            61: The codes are:
        !            62: 
        !            63: .in +8
        !            64: .nf
        !            65: gt     GT40-GT42 specific routines
        !            66: tk     Tektronix 4014 specific routines
        !            67: tv     Device independent routines
        !            68: .fi
        !            69: .in -8
        !            70: 
        !            71: GRAFPAC has been organized so that the
        !            72: proceedure level interface is machine independent.
        !            73: 
        !            74: .sh 1
        !            75: Display Terminal Support
        !            76: .PS
        !            77: \*(GQ supports two types of display
        !            78: terminals: Digital Equipment Corporation's
        !            79: GT40-GT42, and Tektronix's 4014.
        !            80: The Tektronix 4014 version can be used to
        !            81: drive any 4010 type terminal but a
        !            82: 4014 with extended graphics module is expected.
        !            83: 
        !            84: When running \*(GQ in background or from a
        !            85: terminal that cannot display graphic output,
        !            86: it must guess which type of display list should
        !            87: be drawn, GT40-GT42 or 4014 type.
        !            88: The default has been set to
        !            89: 4014.
        !            90: If you would prefer another
        !            91: default the file .../geoquel/geoquel.c
        !            92: must be changed.
        !            93: Specifically, the three compile options
        !            94: at the head of the file must be adjusted.
        !            95: See the comment in the code for further
        !            96: information.
        !            97: 
        !            98: To use a GT40 or GT42, you must load a monitor program
        !            99: in the PDP-11.
        !           100: This monitor can be found in .../geoquel/gt42.
        !           101: A loaded copy of the monitor is supplied
        !           102: in .../geoquel/gt42/gt42mon and can be used directly.
        !           103: Simply 'cat' this file to the terminal.
        !           104: 
        !           105: .ti +10
        !           106: cat .../geoquel/gt42/gt42mon
        !           107: 
        !           108: The format of this file is suitable for use with
        !           109: the standard ROM loader normally at address 166000.
        !           110: 
        !           111: If you decide to provide support for
        !           112: another graphic device, you must re-write
        !           113: the routines in .../geoquel/grafpac.
        !           114: Naturally, we would be interested in hearing
        !           115: about any other devices you develop support for.
        !           116: 
        !           117: .sh 1
        !           118: Possible source code changes.
        !           119: .dn
        !           120: If your machine has a hardware floating point unit.
        !           121: .PS
        !           122: You may wish to recompile \*(GQ without the
        !           123: software floating point interpreter.
        !           124: This will not affect the operation in any way
        !           125: (since the software interpreter
        !           126: will not be used if your
        !           127: machine has floating point hardware).
        !           128: The resulting copies of the object code will be
        !           129: somewhat smaller.
        !           130: There are various shell files which contain
        !           131: C-compile statements.
        !           132: On each of these
        !           133: the "-f" flag must be removed.
        !           134: The shell files are all located in the directory .../geoquel/setup.
        !           135: The one exception is .../setup/geoquel.sh.
        !           136: 
        !           137: .in +8
        !           138: ed .../setup/geoquel.sh
        !           139: .ti +5
        !           140: (find "-f" on cc statement and remove)
        !           141: .br
        !           142: chdir .../geoquel/setup
        !           143: .ti +5
        !           144: (examine all files and remove -f's)
        !           145: .in -8
        !           146: 
        !           147: .sh
        !           148: Recompilation.
        !           149: .PS
        !           150: To recompile \*(GQ, execute the command:
        !           151: 
        !           152:        setup geoquel
        !           153: 
        !           154: This command will recompile \*(GQ from the
        !           155: source code.
        !           156: Various messages will be printed on the terminal telling
        !           157: you what is being done and where it is.
        !           158: The resulting copy of \*(GQ will be placed in .../bin/geoquel.
        !           159: It should be moved to /usr/bin/geoquel.
        !           160: 
        !           161: .sh 1
        !           162: Setting up the ttytype file.
        !           163: .PS
        !           164: If you have been using version 4.0 of \*(GQ,
        !           165: you will not need to do this step.
        !           166: 
        !           167: The ttytype file describes
        !           168: each terminal on your system.
        !           169: \*(GQ will
        !           170: not attempt to display graphical output on terminals
        !           171: that are not capable of displaying it.
        !           172: There is a sample of the file in
        !           173: 
        !           174: .ti +8
        !           175: ".../geoquel/ttytype.sample".
        !           176: 
        !           177: This is a copy of the file in use on the Berkeley system.
        !           178: 
        !           179: The ttytype file consists of a series of
        !           180: lines;
        !           181: the first character is the terminal id,
        !           182: and the rest of the line tells
        !           183: the type of the terminal.
        !           184: The first of these characters is a terminal class,
        !           185: and the rest signify the brand, or some other more
        !           186: descriptive indication.
        !           187: A completely blank line terminates the useful part
        !           188: of the file, after which comments may 
        !           189: appear unrestricted.
        !           190: In the sample file the currently recognized
        !           191: (defined) terminal types are listed.
        !           192: 
        !           193: Edit the sample file or create a new one to
        !           194: match your system.
        !           195: Place the file in .../files/ttytype:
        !           196: 
        !           197: .ti +8
        !           198: mv .../geoquel/ttytype.sample  .../files/ttytype
        !           199: 
        !           200: .sh 1
        !           201: Previous versions of \*(GQ.
        !           202: .PS
        !           203: The large change in version number (4.0 to 6.2)
        !           204: was done so that \*(GQ matches the \*(II version numbering.
        !           205: 
        !           206: There has been very few external changes to the
        !           207: \*(GQ language.
        !           208: The HISTOGRAM command was greatly improved and the documentation
        !           209: cleaned up.
        !           210: In later modifications of \*(GQ there will be
        !           211: some additional monitor commands and the underlying
        !           212: graphics package will be updated.
        !           213: Also, a rudimentary facility for accessing the \*(II
        !           214: HELP and PRINT commands was added.

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