CUT&PASTE 2.3

by Dennis R. LaBelle
29 Dewey Avenue
Windsor, Ct 06095

Compuserve 71350,3312
Genie D.LABELLE


This program is provided free for personal, private use. Commercial and
corporate use beyond a trial period of 30 days requires registration and the
purchase of a license.

In any case, the program may be copied and shared with others.

The author makes no warranties, either express or implied, regarding the
program's merchantability, or its fitness for any particular purpose. All
commercial rights are reserved by the author.


>>> GENERAL DESCRIPTION <<<

CUT&PASTE is a memory resident program written in C for the IBM PC and
compatibles. DOS 2.0 or later is necessary to run the program. ALT ENTER
is the default key sequence used to call the CUT&PASTE program. The key
sequence which calls CUT&PASTE may be changed to better suit your needs.

Have you ever wanted to save or transfer some information which appeared on
the screen to some other program or file? Was there ever a data transfer you
needed to make between programs, but there just wasn't a way to do it!
Well, now there is. CUT&PASTE is a memory resident utility which will allow
you to do these marvelous things plus a few more.

The program provides you with a capture buffer into which you may place
sections of the text screen or read a file. Use of the PASTE menu option
will discharge the buffer as if its contents were being typed to the
keyboard by the user.

CUT&PASTE should work in all text modes of either your monochrome, CGA, EGA
or VGA video card. Additionally, the program has been tested to work in the
extended modes (e.g. 132 columns by 43 lines) of the EGA Wonder+ card by ATI
Technologies, Inc. and the Tatung VGA card. The extended modes of other
video adapter brands may also work.


>>> SYSTEM REQUIREMENTS <<<

Running CUT&PASTE requires the following:

IBM PC or compatible
80K of RAM available for making CUT&PASTE memory resident
Monochrome, CGA, EGA or VGA video adapters
DOS 2.0 or later


>>> FILES PROVIDED <<<

PASTE.EXE CUT&PASTE program
PASTE.DOC documentation for CUT&PASTE


>>> USING CUT&PASTE <<<

Program features -

Once CUT&PASTE has been made resident, its features may be invoked at
any time by pressing the hot key sequence. ALT ENTER is the default
key sequence used to call the CUT&PASTE program. The key sequence
which calls CUT&PASTE may be changed to better suit your needs. This
can be done when first loading the program by including command line
arguments that define the hot keys. The following are valid command
line arguments that may be used to redefine the hot key combination.

CTRL - represents the Ctrl key
ALT - represents the Alt
RIGHT_SHIFT - represents the right shift key
LEFT_SHIFT - represents the left shift key
a number - represents the scan code for any other key

The hot key sequence can be almost any combination of CTRL, ALT or
SHIFT keys plus another key on the keyboard.

The CUT&PASTE program itself may be used to determine the proper
command line arguments for a particular hot key combination. If the
program is called with HOTKEY as a parameter, you will be asked to
press the key sequence you wish to use for the hot key. After
pressing your desired key combination, CUT&PASTE will print out the
the proper command line arguments you should use to redefine the hot
key sequence. CUT&PASTE will not make itself memory resident if the
HOTKEY command line argument is used.

Example use:
---------------------------------------------------------------------

D:\>paste hotkey

Press key sequence you wish to use for hot key.

Proper arguments to obtain this hot key sequence => CTRL ALT 13

CUT&PASTE not loaded.

D:\>

---------------------------------------------------------------------
In the above example the Ctrl, Alt and = keys were pressed when asked
for the hot key sequence. In response, the program printed CTRL ALT
13. You will notice that 13 is the keyboard scan code for the = key.
Therefore, to use this key sequence for the hot key combination the
program should be called as follows: PASTE CTRL ALT 13


>>> USING CUT&PASTE <<<

Program features - (Continued)

Pressing the hot key combination will enable the CUT&PASTE features
and place a help line at the top of the screen to remind you of the
current one key commands.

The CUT&PASTE capture buffer can hold up to 12000 characters.

MOVEMENT

Movement of the cursor to any location on the text screen is
now possible using the following keys:

Up Arrow - move up one line
Down Arrow - move down one line
Left Arrow - move left one character
Right Arrow - move right one character
Home - move to begining of current line
End - move to end of current line
PgUP - move to upper left corner of screen
PgDn - move to lower right corner of screen

COMMANDS

Paste - discharge CUT&PASTE buffer to keyboard
Mark - define a corner of the area to mark
Unmark - remove highlighting from screen
Copy - copy marked area to buffer
Options - go to options menu
Quit - exit CUT feature
Help on/off - toggle help line on or off

MARKING, UNMARKING and COPYING

An area of the text screen must be MARKED prior to copying it
to the capture buffer. To do so, place the cursor at one
corner of the block you wish to copy then press M. Next,
move the cursor to the diagonally opposite corner of the
block of concern and do the same. At this point, the area of
the screen defined by the the corners will be highlighted.
Press C to copy this marked area to the buffer or U to
deselect the area. Either of these two keys must be hit
before any further marking can be done.

When copied to the buffer, end of line characters are
appended to each line within the screen block. Thus, text
found on separate lines of the screen will also appear in the
same manner when placed in the capture buffer. This is
necessary to produce a readable form of the copied text. When
copying to the buffer, characters are appended to the buffer
contents.


>>> USING CUT&PASTE <<<

Program features - (Continued)

PASTING

Use of the PASTE menu option will return you to the original
application and discharge the buffer as if its contents were
being typed to the keyboard by the user. The buffer is not
cleared at this time. Clearing must be performed with
selection [1] of the options menu. Discharge of the capture
buffer contents may be aborted by pressing the ESC key.

OPTIONS MENU

Pressing O will open a window and present the following menu
selections:

1] Clear buffer
2] Save buffer to disk
3] Read file into buffer
4] View buffer contents
5] Set PASTE speed
6] Return to marking
7] Remove CUT&PASTE from memory
8] Exit CUT&PASTE

Notes: a) With option [3], the capture buffer is cleared just
prior to reading the file.
b) Selection [5] permits you to adjust the speed at
which the buffer contents are sent to the keyboard.
c) Selection [6] returns to moving and marking mode.
d) After choosing [7], CUT&PASTE will remove itself
from memory at an appropriate time (i.e. after you
exit all applications loaded on top of CUT&PASTE
and return to DOS).
e) Selection [8] closes the window, and returns to the
original application program.


>>> REVISION HISTORY <<<

Version 1.0 --- Initial release. Program written in Turbo Pascal 3.0

Version 2.0 --- Program rewritten in Microsoft C 4.0 and modified to handle
enhanced video card modes (e.g. 132 columns).
--- Functions by KyCorp used to implement memory residency and
PASTE feature.

Version 2.1 --- KyCorp function no longer used to implement PASTE feature.
New routine written to handle PASTEing. This was done to
eliminate some problems with the pace of the PASTEing.
--- Problems with programs using video display pages other than
page 0 were corrected.
--- Program compiled with Microsoft C 5.0

Version 2.2 --- Functions by KyCorp are no longer used in the program. New
functions were written to replace them. This was necessary
to fix some problems and add new features.
--- The hot key calling sequence for CUT&PASTE may be redefined
using command line arguments. CUT&PASTE may also be used to
determine the necessary command line parameters for this
redefinition.
--- The PASTE speed is now adjustable.
--- Problems related to saving and loading the capture buffer to
and from disk have been corrected. These functions would
eventually cause the computer to freeze up. They now work
properly.
--- CUT&PASTE now works properly with all programs tested.
Please let me know if it fails to work with any you try.
--- The C source code for CUT&PASTE is no longer included in the
distribution package.
Version 2.3 --- Capture buffer size expanded to 45000 characters.
--- Program now allows scrolling through capture buffer using
keypad movement keys (i.e. Home, End, PgUp, PgDn and arrow
keys).
--- The PASTEing of the capture buffer contents may be aborted
by pressing the ESC key.