Annotation of researchv10dc/man/man10/graw.10, revision 1.1

1.1     ! root        1: .TH GRAW 1 UCDS
        !             2: .SH NAME
        !             3: graw \- gnot graphic editor
        !             4: .SH SYNOPSIS
        !             5: .B graw
        !             6: [
        !             7: .B -f
        !             8: .I fontfile
        !             9: ]
        !            10: [
        !            11: .B -g
        !            12: ]
        !            13: [
        !            14: .I file ...
        !            15: ]
        !            16: .SH DESCRIPTION
        !            17: .PP
        !            18: .I Graw
        !            19: is a multi-file graphic editing program specialized for schematic entry.
        !            20: .I Graw
        !            21: drawings consist of lines, boxes, text objects, and instantiations of previously
        !            22: defined drawings called
        !            23: .I masters.
        !            24: The
        !            25: .I graw
        !            26: user interface differs from that of most 5620/gnot programs in that button 1
        !            27: controls
        !            28: .I all
        !            29: graphical entry.
        !            30: .PP
        !            31: The
        !            32: .B -g
        !            33: flag invokes an experimental mode in which
        !            34: .B graw
        !            35: attempts to render in grey scale.
        !            36: The
        !            37: .B -f
        !            38: flag allows the user to specify a font for displaying text objects.
        !            39: .PP
        !            40: By default, pressing button 1 will create a line with one end fixed and the other
        !            41: end attached to the cursor as long as button 1 is held down.  Objects other than
        !            42: lines can be drawn by prefacing a drawing operation with a button 2
        !            43: .B onesies\(->
        !            44: selection.
        !            45: Button 1 is also used for
        !            46: .I grabbing
        !            47: objects.  Grabbing takes precedence over drawing, and
        !            48: .I graw
        !            49: evaluates every button 1 hit to see if there is something to grab.
        !            50: .PP
        !            51: Grabbing rules vary by object.  For example, a box can be grabbed by pointing to
        !            52: its interior.  A grabbed box will cause all objects inside or touching it to be
        !            53: grabbed also.  Grabbing a box's corner will also grab objects touching the two
        !            54: sides of that corner.  An object inside a box may be grabbed without grabbing
        !            55: the box.
        !            56: .I Graw's
        !            57: grabbing rules are meant to be intuitively obvious.  The author apologizes for
        !            58: cases in which this is not true.
        !            59: .PP
        !            60: .I Graw
        !            61: keeps a "text point" at the last location of a button 1 hit.
        !            62: Typing to
        !            63: .I graw
        !            64: creates a text object at the current text point.
        !            65: A text object orients itself based on its surroundings each time it is typed
        !            66: at or moved.
        !            67: Typing a carriage return causes graw to move the current text point down one or
        !            68: two ticks, depending on the surroundings.
        !            69: .PP
        !            70: Buttons 2 and 3 contain editing and file oriented menus, respectively.
        !            71: The button 2 menu entries are
        !            72: .B onesies\(-> (box, dots, macro),
        !            73: .B inst\(->
        !            74: .I (master list),
        !            75: .B sweep, slash, cut, paste,
        !            76: and
        !            77: .B scroll.
        !            78: .RS
        !            79: .TP
        !            80: .B onesies\(->
        !            81: selects a non-line object to be drawn with button 1.
        !            82: You get at most one non-line object per onesie.
        !            83: .TP
        !            84: .B inst\(->
        !            85: selects a master to be instantiated and attached to the cursor until any button
        !            86: is pressed.
        !            87: .TP
        !            88: .B sweep
        !            89: uses a rectangle input with button 1 (N.B.) to grab a set of objects and drag
        !            90: them until any button is pressed.
        !            91: .TP
        !            92: .B slash
        !            93: differs from
        !            94: .B sweep
        !            95: only in that rectilinear lines are first cut by the input rectangle.
        !            96: .TP
        !            97: .B cut
        !            98: undraws and moves the object(s) last drawn or moved to the cut/paste buffer.
        !            99: .TP
        !           100: .B paste
        !           101: attaches a copy of the cut/paste buffer to the cursor until any button is
        !           102: pressed.
        !           103: .TP
        !           104: .B snarf
        !           105: is a
        !           106: .B cut
        !           107: without the undraw.
        !           108: .TP
        !           109: .B scroll
        !           110: attaches the entire drawing to the cursor until any button is pressed.
        !           111: .RE
        !           112: .PP
        !           113: The button 3 menu entries are
        !           114: .B edit, read, write, exit,
        !           115: and
        !           116: .B new,
        !           117: followed by the list of filenames currently being edited.
        !           118: .RS
        !           119: .TP
        !           120: .B edit
        !           121: prompts for a file name and reads in the file for editing.  Backspace and
        !           122: control-W may be used to edit the name; a null file name aborts the operation.
        !           123: .TP
        !           124: .B read
        !           125: prompts for the name of a master file, reads it in, and plants a reference to
        !           126: it in the current file.  The names of the masters in the file are added to
        !           127: those in the
        !           128: .B inst\(->
        !           129: menu for the current file, overwriting older definitions if necessary.
        !           130: .TP
        !           131: .B write
        !           132: prompts for a file name (starting with the current file name).  The non-null
        !           133: result becomes the new file name and the file is written.
        !           134: .TP
        !           135: .B exit
        !           136: terminates the program.  It may be necessary to type a character and/or move the
        !           137: mouse after
        !           138: .I graw
        !           139: exits to really exit.
        !           140: .TP
        !           141: .B new
        !           142: creates a new, unnamed drawing for editing.
        !           143: .PP
        !           144: Selecting a file name selects the current file.
        !           145: .RE
        !           146: .PP
        !           147: .I Graw
        !           148: can read
        !           149: .I jraw
        !           150: format files.  Conversion from
        !           151: .I jraw
        !           152: to
        !           153: .I graw
        !           154: begins with this step and is generally completed by removing library master
        !           155: instantiations from the resulting
        !           156: .I graw
        !           157: format file.
        !           158: .PP
        !           159: .I Jraw -w
        !           160: produces ucds netlist format from
        !           161: .I graw
        !           162: format files. 
        !           163: .PP
        !           164: .I Jb
        !           165: produces postscript from
        !           166: .I graw
        !           167: format files.
        !           168: .SH FILES
        !           169: /n/ross/lib/graw/gates.g       the standard gate file
        !           170: .br
        !           171: /n/ross/sys/font/1/7/PA        default font file
        !           172: .SH SEE ALSO
        !           173: graw(5), cdmglob(1), jb(1), jraw(1), annotate(1)
        !           174: .SH BUGS
        !           175: Loses its little mind when it can't parse input
        !           176: .br
        !           177: Crashes when it reads two
        !           178: .I jraw
        !           179: .B 'e'
        !           180: (end of master) lines in succession.

unix.superglobalmegacorp.com

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