Return to mouse.4 CVS log

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

Annotation of researchv9/jtools/man/man4/mouse.4, revision 1.1

1.1     ! root        1: .TH MOUSE 4
        !             2: .CT 1 comm_term
        !             3: .SH NAME
        !             4: mouse \- jerq mouse user interface
        !             5: .SH DESCRIPTION
        !             6: Most jerq programs use the mouse for control, either by pointing at things
        !             7: on the screen or by making selections from a menu.
        !             8: The mouse buttons are different from keys on a keyboard in that
        !             9: events are reported when a button is released (let `up') as well as
        !            10: depressed (pressed `down').
        !            11: It therefore matters not only
        !            12: .I where
        !            13: and
        !            14: .I when
        !            15: a button is pressed, but for how long.
        !            16: For example, menus are drawn when a button is depressed, and remain
        !            17: displayed as long as the button is held down.
        !            18: While the button is down, moving the cursor over the menu highlights
        !            19: entries in the menu; the entry (possibly none) under the
        !            20: cursor when the button is
        !            21: .I released
        !            22: is the selection returned to the program.
        !            23: Large menus also present a
        !            24: `scroll bar'
        !            25: on the left side of the menu.
        !            26: Moving the mouse inside the scroll bar chooses which subset of the
        !            27: available entries are displayed and therefore selectable.
        !            28: .PP
        !            29: There is a convention about how the buttons are used.
        !            30: The left button (button 1) is used to point:
        !            31: selecting which layer to work in, which file inside the editor,
        !            32: some text in the file, etc.
        !            33: The middle button (button 2) produces
        !            34: a menu of actions related to the selection:
        !            35: remove the selected text, replace it, etc.
        !            36: The right button (button 3) presents a menu of global, program-wide actions:
        !            37: pick up a new file, rearrange the files on the screen, etc.
        !            38: Programs follow this convention well enough that an unfamiliar program
        !            39: can often be learned simply by trying it.
        !            40: The main violators of the convention are drawing programs,
        !            41: which use button 1 to draw things and button 2 to undraw them,
        !            42: but this is also a consistent convention.
        !            43: .PP
        !            44: The mouse cursor is usually an arrow pointing at a pixel, but
        !            45: programs often change the cursor to an iconic representation
        !            46: of the program's state.
        !            47: The most common cursors are:
        !            48: .TP
        !            49: arrow
        !            50: standard cursor
        !            51: .TP
        !            52: coffee cup
        !            53: Program will be busy for a while.
        !            54: .TP
        !            55: rectangle and arrow
        !            56: Program expects a rectangle to be `swept out' by pressing
        !            57: a button (usually 3) at one corner and releasing at the diagonally opposite corner.
        !            58: .TP
        !            59: gunsight
        !            60: Program expects an object to be selected by pointing at it and pressing a button (usually 3).
        !            61: .TP
        !            62: upside-down mouse
        !            63: Program is thinking; the mouse is inoperative.

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