Annotation of researchv10dc/man/adm/man9/intro.9, revision 1.1.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.

unix.superglobalmegacorp.com

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