Return to intro.9 CVS log

Up to [Research Unix] / researchv10dc / man / man9

Annotation of researchv10dc/man/man9/intro.9, revision 1.1

1.1     ! root        1: .TH INTRO 9
        !             2: .SH NAME
        !             3: intro \- introduction to 5620-related software
        !             4: .SH SYNOPSIS
        !             5: .BI PATH= stuff :/usr/jerq/bin
        !             6: .SH DESCRIPTION
        !             7: Section 9 of this manual lists software for running or supporting
        !             8: Teletype DMD-5620 terminals.
        !             9: Subsections 9.1-9.7 mirror the purposes of the preceding sections 1-7,
        !            10: with 9.1 being commands, 9.6 being games, etc.
        !            11: Command synopses assume that the shell search path includes
        !            12: .FR /usr/jerq/bin .
        !            13: .PP
        !            14: Few commands deal with a 5620 in native mode.
        !            15: .IR 32ld (9.1)
        !            16: loads programs into the terminal and
        !            17: .IR mux (9.1)
        !            18: starts the characteristic `layer' or window system.
        !            19: Almost all other commands in section 9 either run on
        !            20: Unix or within
        !            21: .I mux
        !            22: layers.
        !            23: .PP
        !            24: A layer is technically a virtual terminal,
        !            25: but is almost indistinguishable in software from a real terminal;
        !            26: in particular, the interface described in
        !            27: .IR ttyld (4)
        !            28: applies to layers, except for the additional editing capabilities discussed in
        !            29: .IR mux (9.1).
        !            30: .PP
        !            31: The commands in sections 9.1 and 9.6 run on Unix,
        !            32: but most implicitly call
        !            33: .I 32ld
        !            34: to down-load a program that replaces the
        !            35: default terminal process running in the layer.
        !            36: To Unix the interface is still that of
        !            37: a terminal; in particular
        !            38: .F /dev/tty
        !            39: (see
        !            40: .IR fd (4))
        !            41: is always connected to the layer.
        !            42: The default
        !            43: .I mux
        !            44: terminal program implements the teletype driver function itself.
        !            45: When a program is down-loaded,
        !            46: there is no teletype driver;
        !            47: programs that desire one
        !            48: must push the teletype line discipline on the stream,
        !            49: and arrange to pop the line discipline
        !            50: on exit; see
        !            51: .IR stream (4)
        !            52: and
        !            53: .IR ttyld (4).
        !            54: Some commands may simply
        !            55: emulate other terminals by down-loading
        !            56: a terminal program (see
        !            57: .IR term (9.1);
        !            58: others, such as the text editor
        !            59: .IR sam (9.1),
        !            60: are really two programs \(em one on Unix and one in the layer \(em
        !            61: communicating using standard input/output on Unix
        !            62: and
        !            63: .BR sendchar() / rcvchar()
        !            64: in the terminal; see
        !            65: .IR request (9.2).
        !            66: .PP
        !            67: There is an identity between bitmaps and layers
        !            68: in the graphics software.
        !            69: Graphic objects are bitmaps.
        !            70: The 
        !            71: .IR newlayer (9.2)
        !            72: primitives that operate on layers are aliased to bitmap
        !            73: primitives of (9.3), and the data structures are isomorphic.
        !            74: When running under
        !            75: .IR mux ,
        !            76: a programmer need not consider layers as graphical objects
        !            77: at all; the operating system checks the arguments to the graphics
        !            78: primitives and dispatches the appropriate operator depending
        !            79: on the type of the argument.
        !            80: Except in stand-alone software, layers are an invisible
        !            81: implementation detail.
        !            82: .SS Teletype 630
        !            83: .I Mux
        !            84: and various programs that run in
        !            85: .I mux
        !            86: layers have been ported to Teletype DMD-630 terminals.
        !            87: The ported software is not available on all machines and
        !            88: is not specifically documented.
        !            89: Look in
        !            90: .F /usr/630/bin
        !            91: to see what's there.
        !            92: .SH FILES
        !            93: .TF /usr/jerq/mbin
        !            94: .TP
        !            95: .F /usr/jerq/bin
        !            96: jerq-related Unix object programs
        !            97: .TP
        !            98: .F /usr/jerq/mbin
        !            99: terminal programs, usually down-loaded automatically
        !           100: by programs in
        !           101: .F /usr/jerq/bin
        !           102: .TP
        !           103: .F /usr/630/bin
        !           104: 630-related Unix object programs
        !           105: .TP
        !           106: .F /usr/630/lib
        !           107: terminal programs
        !           108: .SH SEE ALSO
        !           109: .IR 32ld (9.1), 
        !           110: .IR mux (9.1), 
        !           111: .IR stream (4)
        !           112: .SH BUGS
        !           113: There are two mechanical-drawing programs,
        !           114: .I cip
        !           115: and
        !           116: .I ped,
        !           117: two `artistic' drawing programs,
        !           118: .I paint
        !           119: and
        !           120: .I twid,
        !           121: one `graphic' drawing program,
        !           122: .I brush,
        !           123: two pixel-level drawing programs,
        !           124: .I icon
        !           125: and 
        !           126: .I jf,
        !           127: all for working on binary images.
        !           128: None dominates.

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