Return to sux.1 CVS log

Up to [Research Unix] / researchv9 / jtools / man / man1

Annotation of researchv9/jtools/man/man1/sux.1, revision 1.1.1.1

1.1       root        1: .TH SUX 1
                      2: .CT 1 comm_term
                      3: .SH NAME
                      4: sux - mux style terminal windows for X11 and suntools
                      5: .SH SYNOPSIS
                      6: .B sux
                      7: .SH DESCRIPTION
                      8: .I Sux
                      9: creates in interactive terminal window for \fIX11\fR
                     10: and \fIsuntools\fR which emulates 9th Edition \fImux\fR terminal
                     11: windows.
                     12: When sux is started, a separate shell
                     13: (the value of the
                     14: .B SHELL
                     15: environment variable, or
                     16: .I sh
                     17: by default)
                     18: is established, and bound to the window.
                     19: .PP
                     20: There is a point
                     21: in each window, called the `Unix point', where
                     22: the next character from Unix will be inserted.
                     23: The Unix point advances whenever characters
                     24: are received from Unix, but not when echoing typed characters.
                     25: When a newline is typed after the Unix point,
                     26: characters between the Unix point and the newline,
                     27: inclusive, are sent to Unix and the
                     28: Unix point advanced to after the newline.
                     29: This means that
                     30: shell prompts and other output will be inserted before
                     31: characters that have been typed ahead.
                     32: No other characters are sent to Unix (but see the discussion of raw mode
                     33: below).
                     34: Therefore partially typed lines or text anywhere before the Unix
                     35: point may be edited.
                     36: .PP
                     37: .I Sux
                     38: allows any text on the screen to be edited, much as in
                     39: .IR sam (1).
                     40: Text may be selected by sweeping it with button 1 depressed.
                     41: Typed characters replace selected text.
                     42: .PP
                     43: All \fIsux\fR windows share a common `snarf buffer' (distinct from
                     44: .IR sam 's).
                     45: The
                     46: .B cut
                     47: operation on button 2 deletes selected text and puts it
                     48: in the buffer;
                     49: .B snarf
                     50: copies selected text to the buffer;
                     51: .B paste
                     52: replaces selected text (which may be null) from the buffer; and
                     53: .B send
                     54: copies the snarf buffer to after the Unix point.
                     55: .PP
                     56: Normally the terminal doesn't scroll
                     57: as text is received, but a button 2 menu item selects scrolling.
                     58: .PP
                     59: A scroll bar indicates what portion of all the text stored
                     60: for a \fIsux\fR window is on the screen.
                     61: (It measures characters, not lines.)
                     62: Releasing button 1 in the scroll bar brings the line at the top
                     63: of the screen to the cursor;
                     64: releasing button 3 takes the line at the cursor
                     65: to the top of the screen.
                     66: Button 2, treating the scroll bar as a ruler, brings the indicated
                     67: point in the whole stored text to the top of the screen.
                     68: .PP
                     69: In raw mode or no-echo mode (see
                     70: .IR tty (4))
                     71: the Unix point advances with each character
                     72: typed after it.
                     73: .SH SEE ALSO
                     74: .IR sam (1), 
                     75: .SH BUGS
                     76: On non-9th Edition systems, it is not possible for
                     77: .I sux
                     78: to determine when the line discipline changes to and from raw mode.
                     79: As a result,
                     80: .I sux
                     81: always assumes it is in raw mode so it is not possible to use the mouse
                     82: to edit partially typed lines.

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