Return to blitblt.9 CVS log

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

Annotation of researchv10dc/man/adm/man9/blitblt.9, revision 1.1

1.1     ! root        1: .TH BLITBLT 9.1
        !             2: .CT 1 comm_other
        !             3: .SH NAME
        !             4: blitblt, menudrop \- save or print a screen image
        !             5: .SH SYNOPSIS
        !             6: .B blitblt
        !             7: [
        !             8: .B -p
        !             9: .I command
        !            10: ]
        !            11: .PP
        !            12: .B menudrop
        !            13: .SH DESCRIPTION
        !            14: .I Blitblt
        !            15: copies a selected area of a
        !            16: .IR mux (9.1)
        !            17: screen into a file
        !            18: or to a program.
        !            19: It is menu-driven off button 3 to select a
        !            20: rectangular area and to treat it by flipping the
        !            21: border from wide to narrow and back, inverting video,
        !            22: saving the selcted area in a file, or sending 
        !            23: it to a program, usually for printing.
        !            24: Details of certain menu items:
        !            25: .nr xx \w'\f5sweep rectangle\f1'u+2n/1n
        !            26: .TP \n(xx
        !            27: .TP
        !            28: .B choose layer
        !            29: .br
        !            30: .ns
        !            31: .TP
        !            32: .B layer rectangle
        !            33: One gets the bits of a layer, obscured or not; the other
        !            34: gets screen bits including superposed layers.
        !            35: .TP
        !            36: .B run/halt
        !            37: Restart or stop the terminal
        !            38: process in the selected layer.
        !            39: .TP
        !            40: .B write file
        !            41: Write the selected area into a file or pipe in
        !            42: .IR bitfile (9.5)
        !            43: format.
        !            44: The filename is typed 
        !            45: at the bottom of the
        !            46: .I blitblt
        !            47: layer.
        !            48: A bare newline repeats the previous name.
        !            49: If the first character is
        !            50: .LR | ,
        !            51: the remainder of
        !            52: the line is taken as a shell command to pipe into.
        !            53: (A likely command is
        !            54: .BR |lp 
        !            55: for hard copy.)
        !            56: .TP
        !            57: .BI | " command"
        !            58: Pipe the selected area to the
        !            59: .I command
        !            60: specified by the
        !            61: .B -p
        !            62: option.
        !            63: .PP
        !            64: .I Menudrop
        !            65: may be used with
        !            66: .IR blitblt
        !            67: to make images containing `menus'
        !            68: as fraudulent overlaid layers.
        !            69: The program is menu-driven off button 3:
        !            70: .nr xx \w'\f5drop menu\f1'u+2n/1n
        !            71: .TP \n(xx
        !            72: .B drop menu
        !            73: A
        !            74: .RI non- mux
        !            75: menu selected in another window will be drawn 
        !            76: and will remain on screen after
        !            77: the button selecting the menu has been released.
        !            78: Subsequent menu selections
        !            79: will delete the previous menu layer and create a new one.
        !            80: Once such a menu-bearing layer is present, the
        !            81: .I menudrop
        !            82: menu changes to allow cursor placement, highlighting of menu items, 
        !            83: lifting of the displayed menu, etc.
        !            84: The functionality of the program using the menu is not affected.
        !            85: .TP
        !            86: .B mux menus
        !            87: The next click of button 1 or 2 will drop the corresponding (non-functional)
        !            88: .I mux
        !            89: menu at the mouse position.
        !            90: .TP
        !            91: .B exit
        !            92: .I Menudrop
        !            93: will exit in a clean manner.
        !            94: .SH EXAMPLES
        !            95: .TP
        !            96: .L blitlblt -p lp
        !            97: .br
        !            98: .ns
        !            99: .TP
        !           100: .L
        !           101: blitblt -p "lp -p bpost"
        !           102: Arrange for piping output to a laser printer: a good
        !           103: way, and a surefire way.
        !           104: .SH SEE ALSO
        !           105: .IR mbits (6),
        !           106: .IR bitfile (9.5)
        !           107: .SH BUGS
        !           108: Animated layers result in broken images.
        !           109: Use the
        !           110: .B halt
        !           111: function.
        !           112: .br
        !           113: If a pipe request fails, the
        !           114: .I blitblt
        !           115: layer becomes unusable.
        !           116: .br
        !           117: The default 
        !           118: .I command
        !           119: for
        !           120: .L "write file"
        !           121: is obsolete.
        !           122: .br
        !           123: Deleting a
        !           124: .I menudrop
        !           125: layer, rather than exiting through the menu, can crash the terminal.
        !           126: .br
        !           127: Programs that use private menu packages are unaffected by
        !           128: .IR menudrop ;
        !           129: using a debugger to stop a program in midmenu may
        !           130: get the same effect.

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