-={ RETRIEVING DELETED TEXT IN WORDSTAR }=-
by Laurie J. Braaten
Anyone who has worked with WordStar for any length of time has
probably had the misfortune of deleting the wrong line or block
of text. By some fancy manuevering, you might be able to recover
the text from your backup file. If you have a photographic
memory, you may be able to retype it in no time. But if these do
not work, you should be set for a frustating time trying to
reconstruct your lost data. Now you can avoid this problem
altogether by adding a "Yankback" feature to WordStar. This can
be done quite simply with a series of command strings ("macros")
which I call "WS Yankback," set up in a key definition program.
(The more popular commercial key definition programs such as
Smartkey, Xtrakey and the Backgrounder have been reviewed by
Glenn Grant in the December 1985 issue of PROFILES. KSSTROKES
4.0, QWIKEY21, & GKEY2 are public domain programs which give
good, but more limited results.)
HOW TO SET UP WS YANKBACK
FIRST, set up four macros which will now be used to delete text
in place of their WordStar counterparts. The first will delete a
line. The second will delete a block of text. The third deletes
text left of the cursor; the fourth deletes text right of the
cursor. All macros should be entered as continuous text without
spaces. The ^ symbol is the control key, held down while you
type the key which follows it; <cr> is a carriage return (or ^M).
MACRO #1: ^QS^KB^X^S^KK^KWA:YANKEE<cr>Y^KY
MACRO #2: ^KWA:YANKEE<cr>Y^KY
MACRO #3: ^KK^QS^KB^KWA:YANKEE<cr>Y^KY
MACRO #4: ^KB^X^QS^S^KK^KWA:YANKEE<cr>Y^KY
SECOND, enter the yankback command:
MACRO #5: ^KRA:YANKEE<cr>
THIRD, on your WordStar disk, open a file named "YANKEE." This
is where your deleted text will be stored. This file will be
overwritten every time you delete text, so it does not matter
what you type in it--a single character will do. But make sure
that you have adequate disk space for any text you may want to
delete (2K-6K should be plenty for most operations).
Now, when you want to delete a line, use macro #1. It works just
like ^Y: place the cursor anywhere on a line and use it to delete
the entire line. If you want to yank back the deleted line,
execute macro #5. When deleting a block of text, use macro #2 in
the same way you would use ^KY. Mark the beginning and end of
the block with ^KB and ^KK respectively, and execute macro #2 to
delete the marked block. If the block needs to be recovered,
macro #5 will yank it back. Numbers 3 and 4 work like ^Q<del>
and ^QY--only now the deleted text can be retrieved with the
yankback command. (Macro #1 leaves a blank line where the text
has been removed. If this is undesirable simple omit the ^S
after the ^X.)
Before using WS Yankback, be sure to test it thoroughly. If
there are errors in the way the macros were entered you could
lose more text than you planned to delete, and not be able to
recover it. Use a practice file and check all of the commands.
If they do not work, carefully recheck the macros to make sure
they have been entered correctly.
N.B. The yankback command WILL NOT WORK if you use ^Y, ^KY,
^Q<del> or ^QY to delete text. The four macros given above must
be used instead of these WordStar commands for the yankback to
recover the deleted text.
HOW WS YANKBACK WORKS
WS Yankback simply writes the deleted text onto the file named
YANKEE, and then deletes it from the working text. When the
yankback is used, the text is read back into your file at the
present position of the cursor. This operation takes some time,
which is its major drawback. When deleting blocks of text,
however, it may be worth the extra time to have the assurance
that the data can be recovered. Since WS Yankback always writes
the deleted line on the text YANKEE, the recovery operation will
ONLY WORK FOR THE LAST DELETION--you cannot retrieve any
materials deleted before the last text was deleted.
WHAT ABOUT ^Y ?
If you decide to use the first macro in place of ^Y, you may find
that you still have problems with ^Y. You may accidentally hit
^Y when you want a ^T, or you may attempt to type an upper case
"Y" (which, believe or not, I use quite often) and hit the
control key instead of the shift key. I have solved this problem
by following Ted Silveira's advice in PROFILES, July/August 1985,
p. 44. Using DDT (etc.) or Winstall's custom patch "+" (which
does not appear on the options menu), you may change address 054D
(0535 in WordStar 3.0) to read "19 19" (hex) instead of "19 00."
The result is that it now takes TWO ^Ys (or ^YY) to delete a
line, minimizing the possibilities for an accident. Now when a
^Y is hit by mistake, the space bar will get you out of the
partially executed command. If you find yourself rapidly typing
two or more ^Ts without looking at either the keyboard or the
results onscreen, you may want to try Melvyn Halbert's solution,
found on the Tampa Bay KUG board (813-791-1454). He suggests
changing the "19" at the appropriate address to "1C" (hex), which
will reassign the delete line function to ^\ instead of ^Y.
nging the "19" at the