Metropoli BBS
VIEWER: cutpaste.doc MODE: TEXT (ASCII)
                             CUTPASTE Documentation
                  Gerry Boyd, Larry Weiss and Stephen R. Davis
                          Modifications by Mike Geyer
                                 June 17, 1989



     Background
     ----------
     CUTPASTE is a handy TSR (terminate and stay resident) utility which 
     "transports" a screen-full or less of ASCII characters between 
     applications.  See the original authors' documentation, reproduced 
     below, for a fuller description.  


     Purpose
     -------

     This version of CUTPASTE embodies minor enhancements to the original 
     version written by Boyd, Weiss and Davis.  The motivation for this 
     version was that CUTPASTE would not popup over a couple of programs 
     when used with my enhanced (101 key) AT-style keyboard.  Most 
     importantly, my AT-compatible would hang if my favorite ASCII 
     editor, QEDIT v2.07A, was invoked when CUTPASTE was resident.  


     Functional Enhancements
     -----------------------

        o  This version works properly with enhanced keyboards -- will
           pop up over applications which use the enhanced keyboard
           interrupts and will not hang machine
                         
        o  With this version, it is not necessary to mark an extra
           character past the last one that you really want

        o  When pasting a carriage return, this version inserts a scan
           code in addition to the ASCII character number 13 (when the
           scan code is omitted, QEDIT does not interpret the carriage
           return character properly)

        o  This version does not paste trailing blanks, even on the
           last line.


     Keystrokes for Activation
     -------------------------
     The hot-keys are identical to those for the original version

           Alt-Fn9:  When in DOS or application, enables CUTPASTE and
                     places user in the edit mode
                     When in CUTPASTE, returns user to original program 
                     (DOS or application), with paste buffer empty

           Ctl-Fn9:  Pastes contents of paste buffer into currently
                     running program at cursor position.


     Keystrokes for Editing
     ----------------------
     I have changed some of the edit mode keystrokes to suit my preferences.
     The full set of keystrokes available is:

     This
     Version      Original     Function
     -------      --------     --------
     Fn1          End          Begin/end marking for paste buffer
     PgUp         Home         Move cursor to top line of screen
     PgDn         N/A          Move cursor to bottom line of screen
     Home         Return       Move cursor to left edge of screen
     End          N/A          Move cursor to right edge of screen
     Arrow keys   Arrow keys   Move cursor one position to left/right/up/down
     Ctl-LftArw   Ctl-LftArw   Move cursor left to beginning/end of word
     Ctl-RgtArw   Ctl-RgtArw   Move cursor right to beginning/end of word
     Fn7          PgUp         Delete current line
     Fn6          Esc          Delete text from cursor to end of line
     Bksp         Bksp         Delete one character to left of cursor
     Del          Del          Delete character at cursor position
     Ins          Ins          Insert a blank character at cursor position
     Return       PgDn         Insert a blank line at current cursor line

     N/A means not available


     Acknowledgement
     ---------------

     The enhancements included in this version are minor.  Credit for
     usefulness of CUTPASTE should go the original authors.  In addition,
     they are to be thanked for releasing their source code.

     The authors' original documentation follows.



     ====================================================================

                             CutPaste v2.0
     
         The CutPaste utility is a resident, install at bootup,
     utility.  It is quite small, using less than 6K of memory.
     With cut/paste anything which appears on the screen may be 
     "cut" out and saved for later "pasting" into an application.
     CutPaste is installed by executing the CUTPASTE.COM file
     from either the command line or the AUTOEXEC.BAT file.
     
         Once installed, CutPaste may be brought up at any time by
     entering Alt-Fn9.  The cursor will move to its position on the
     screen when CutPaste was last exited.  Use the arrow keys to move
     the cursor to any place on the screen.  The screen may be edited
     using the keys detailed below.  Place the cursor at one corner of
     the area to be cut out and depress the END key.  Notice that the 
     character underneath the cursor turns to inverse video.  Now move 
     the cursor to the opposite corner of the area to be cut out.
     As the cursor is moved the entire area will appear in inverse video.
     Depress the END key one more time and the screen returns to normal.
     You are now "out" of CutPaste.  To paste the cut area into the
     application, enter Ctl-Fn9.  The box cut previously will be
     "typed" into the application, as if reentered from the keyboard,
     starting at the upper left hand corner and proceeding to the
     lower right hand corner.  If you wish to exit CutPaste without
     cutting anything, reenter the Alt-Fn9 key.
     
         CutPaste will add block move capabilities to any word
     processor (or other program) which using BIOS interrupt 16 for
     keyboard input (that's just about everything except XYWRITE). 
     CutPaste has been tested with many other installables, notably
     SideKick and the MicroSoft and Mouse Systems mouse drivers. 
     (CutPaste works GREAT with a mouse.)
     
         CutPaste only works in alphanumeric mode.
     
         Below is a layout of the keys to which CutPaste assigns editing
     meaning.  Any key which CutPaste does not understand, it merely
     displays as ASCII.  Depressing Alt-Fn9 enters and exits CutPaste.
     
     |-----------------------------------------------------------
     |             |              |              |              |
     |             |  HOME        |  UP ARROW    |   PG UP      |
     |             |move to top of|  move cursor |delete current|
     | RETURN      |screen        |      up      |    line      |
     |go to the    ---------------|--------------|--------------|
     |first char   |              |              |              |
     |of the next  |  LEFT ARROW  |              | RIGHT ARROW  |
     |line         | move cursor  |              | move cursor  |
     |             |    left      |              |    right     |
     |-------------|--------------|--------------|--------------|
                   |              |              |              |
                   |    END       |  DOWN ARROW  |   PG DOWN    |
                   | mark area to | move cursor  |insert a blank|
                   |    cut       |    down      |line at cursor|
     |-------------|--------------|--------------|--------------|
     |                            |                             |
     |          INSERT            |           DELETE            |
     |   insert a blank character |   delete current character  |
     |                            |                             |
     |-------------|--------------|--------------|---------------
     

     
     other keys:
     
     |-------------|              |----------------|
     |             |              |                |
     |   ESC       |              | <-- (backspace)|
     |delete from  |              | delete char    |
     |cursor right |              |  to left       |
     |-------------|              |----------------|
     
     
     
     |-------------|              |----------------|
     |             |              |                |
     |^RIGHT-ARROW |              | ^LEFT-ARROW    |
     |move to next |              |move to next    |
     | spc/nonspc  |              | spc/nonspc     |
     | to the right|              | to the left    |
     |-------------|              |----------------|
     
     
         CutPaste is being offered into the public domain.  No
     remuneration is asked for; however, if any improvements are made
     please check with us first.  We do not want "buggy" versions
     being passed about.  Further, we ask that our names not be
     removed from the source listings or from the .DOC files.  
     Thank you.
     
     Gerry Boyd
     Larry Weiss
     PO Box 831420
     Richardson, TX 75083-1420
     214-238-9545
     
     Stephen R. Davis
     Route 5 Box 107K
     Greenville, Tx 75401
     214-454-2426

[ RETURN TO DIRECTORY ]