home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / library / sampler0 / cutpaste.doc < prev    next >
Text File  |  1989-06-17  |  9KB  |  200 lines
  1.  
  2.                              CUTPASTE Documentation
  3.                   Gerry Boyd, Larry Weiss and Stephen R. Davis
  4.                           Modifications by Mike Geyer
  5.                                  June 17, 1989
  6.  
  7.  
  8.  
  9.      Background
  10.      ----------
  11.      CUTPASTE is a handy TSR (terminate and stay resident) utility which 
  12.      "transports" a screen-full or less of ASCII characters between 
  13.      applications.  See the original authors' documentation, reproduced 
  14.      below, for a fuller description.  
  15.  
  16.  
  17.      Purpose
  18.      -------
  19.  
  20.      This version of CUTPASTE embodies minor enhancements to the original 
  21.      version written by Boyd, Weiss and Davis.  The motivation for this 
  22.      version was that CUTPASTE would not popup over a couple of programs 
  23.      when used with my enhanced (101 key) AT-style keyboard.  Most 
  24.      importantly, my AT-compatible would hang if my favorite ASCII 
  25.      editor, QEDIT v2.07A, was invoked when CUTPASTE was resident.  
  26.  
  27.  
  28.      Functional Enhancements
  29.      -----------------------
  30.  
  31.         o  This version works properly with enhanced keyboards -- will
  32.            pop up over applications which use the enhanced keyboard
  33.            interrupts and will not hang machine
  34.                          
  35.         o  With this version, it is not necessary to mark an extra
  36.            character past the last one that you really want
  37.  
  38.         o  When pasting a carriage return, this version inserts a scan
  39.            code in addition to the ASCII character number 13 (when the
  40.            scan code is omitted, QEDIT does not interpret the carriage
  41.            return character properly)
  42.  
  43.         o  This version does not paste trailing blanks, even on the
  44.            last line.
  45.  
  46.  
  47.      Keystrokes for Activation
  48.      -------------------------
  49.      The hot-keys are identical to those for the original version
  50.  
  51.            Alt-Fn9:  When in DOS or application, enables CUTPASTE and
  52.                      places user in the edit mode
  53.                      When in CUTPASTE, returns user to original program 
  54.                      (DOS or application), with paste buffer empty
  55.  
  56.            Ctl-Fn9:  Pastes contents of paste buffer into currently
  57.                      running program at cursor position.
  58.  
  59.  
  60.      Keystrokes for Editing
  61.      ----------------------
  62.      I have changed some of the edit mode keystrokes to suit my preferences.
  63.      The full set of keystrokes available is:
  64.  
  65.      This
  66.      Version      Original     Function
  67.      -------      --------     --------
  68.      Fn1          End          Begin/end marking for paste buffer
  69.      PgUp         Home         Move cursor to top line of screen
  70.      PgDn         N/A          Move cursor to bottom line of screen
  71.      Home         Return       Move cursor to left edge of screen
  72.      End          N/A          Move cursor to right edge of screen
  73.      Arrow keys   Arrow keys   Move cursor one position to left/right/up/down
  74.      Ctl-LftArw   Ctl-LftArw   Move cursor left to beginning/end of word
  75.      Ctl-RgtArw   Ctl-RgtArw   Move cursor right to beginning/end of word
  76.      Fn7          PgUp         Delete current line
  77.      Fn6          Esc          Delete text from cursor to end of line
  78.      Bksp         Bksp         Delete one character to left of cursor
  79.      Del          Del          Delete character at cursor position
  80.      Ins          Ins          Insert a blank character at cursor position
  81.      Return       PgDn         Insert a blank line at current cursor line
  82.  
  83.      N/A means not available
  84.  
  85.  
  86.      Acknowledgement
  87.      ---------------
  88.  
  89.      The enhancements included in this version are minor.  Credit for
  90.      usefulness of CUTPASTE should go the original authors.  In addition,
  91.      they are to be thanked for releasing their source code.
  92.  
  93.      The authors' original documentation follows.
  94.  
  95.  
  96.  
  97.      ====================================================================
  98.  
  99.                              CutPaste v2.0
  100.      
  101.          The CutPaste utility is a resident, install at bootup,
  102.      utility.  It is quite small, using less than 6K of memory.
  103.      With cut/paste anything which appears on the screen may be 
  104.      "cut" out and saved for later "pasting" into an application.
  105.      CutPaste is installed by executing the CUTPASTE.COM file
  106.      from either the command line or the AUTOEXEC.BAT file.
  107.      
  108.          Once installed, CutPaste may be brought up at any time by
  109.      entering Alt-Fn9.  The cursor will move to its position on the
  110.      screen when CutPaste was last exited.  Use the arrow keys to move
  111.      the cursor to any place on the screen.  The screen may be edited
  112.      using the keys detailed below.  Place the cursor at one corner of
  113.      the area to be cut out and depress the END key.  Notice that the 
  114.      character underneath the cursor turns to inverse video.  Now move 
  115.      the cursor to the opposite corner of the area to be cut out.
  116.      As the cursor is moved the entire area will appear in inverse video.
  117.      Depress the END key one more time and the screen returns to normal.
  118.      You are now "out" of CutPaste.  To paste the cut area into the
  119.      application, enter Ctl-Fn9.  The box cut previously will be
  120.      "typed" into the application, as if reentered from the keyboard,
  121.      starting at the upper left hand corner and proceeding to the
  122.      lower right hand corner.  If you wish to exit CutPaste without
  123.      cutting anything, reenter the Alt-Fn9 key.
  124.      
  125.          CutPaste will add block move capabilities to any word
  126.      processor (or other program) which using BIOS interrupt 16 for
  127.      keyboard input (that's just about everything except XYWRITE). 
  128.      CutPaste has been tested with many other installables, notably
  129.      SideKick and the MicroSoft and Mouse Systems mouse drivers. 
  130.      (CutPaste works GREAT with a mouse.)
  131.      
  132.          CutPaste only works in alphanumeric mode.
  133.      
  134.          Below is a layout of the keys to which CutPaste assigns editing
  135.      meaning.  Any key which CutPaste does not understand, it merely
  136.      displays as ASCII.  Depressing Alt-Fn9 enters and exits CutPaste.
  137.      
  138.      |-----------------------------------------------------------
  139.      |             |              |              |              |
  140.      |             |  HOME        |  UP ARROW    |   PG UP      |
  141.      |             |move to top of|  move cursor |delete current|
  142.      | RETURN      |screen        |      up      |    line      |
  143.      |go to the    ---------------|--------------|--------------|
  144.      |first char   |              |              |              |
  145.      |of the next  |  LEFT ARROW  |              | RIGHT ARROW  |
  146.      |line         | move cursor  |              | move cursor  |
  147.      |             |    left      |              |    right     |
  148.      |-------------|--------------|--------------|--------------|
  149.                    |              |              |              |
  150.                    |    END       |  DOWN ARROW  |   PG DOWN    |
  151.                    | mark area to | move cursor  |insert a blank|
  152.                    |    cut       |    down      |line at cursor|
  153.      |-------------|--------------|--------------|--------------|
  154.      |                            |                             |
  155.      |          INSERT            |           DELETE            |
  156.      |   insert a blank character |   delete current character  |
  157.      |                            |                             |
  158.      |-------------|--------------|--------------|---------------
  159.      
  160.  
  161.      
  162.      other keys:
  163.      
  164.      |-------------|              |----------------|
  165.      |             |              |                |
  166.      |   ESC       |              | <-- (backspace)|
  167.      |delete from  |              | delete char    |
  168.      |cursor right |              |  to left       |
  169.      |-------------|              |----------------|
  170.      
  171.      
  172.      
  173.      |-------------|              |----------------|
  174.      |             |              |                |
  175.      |^RIGHT-ARROW |              | ^LEFT-ARROW    |
  176.      |move to next |              |move to next    |
  177.      | spc/nonspc  |              | spc/nonspc     |
  178.      | to the right|              | to the left    |
  179.      |-------------|              |----------------|
  180.      
  181.      
  182.          CutPaste is being offered into the public domain.  No
  183.      remuneration is asked for; however, if any improvements are made
  184.      please check with us first.  We do not want "buggy" versions
  185.      being passed about.  Further, we ask that our names not be
  186.      removed from the source listings or from the .DOC files.  
  187.      Thank you.
  188.      
  189.      Gerry Boyd
  190.      Larry Weiss
  191.      PO Box 831420
  192.      Richardson, TX 75083-1420
  193.      214-238-9545
  194.      
  195.      Stephen R. Davis
  196.      Route 5 Box 107K
  197.      Greenville, Tx 75401
  198.      214-454-2426
  199.  
  200.