


                                 WordGrab 1.3
                 Copies Words From DOS Screen to Command Line
                Copyright (c) 1995-1996 by David M. Wincelberg


                               Table of Contents

       I.   Introduction ............................................  1
       II.  How to Use ..............................................  2
       III. Free Upgrade Policy .....................................  4

       Appendices:

       A.   Command Line Switches ...................................  5
       B.   Initialization File (WRDGRB.INI) ........................  6
       C.   Registration-Reminder Screen ............................  7
       D.   Troubleshooting .........................................  8
       E.   Other FileJockey Software Products ......................  9
       F.   License Agreement ......................................  11


       I.   Introduction

       WordGrab is a 23K memory-resident program for quickly copying
       text from the DOS screen to the command line using a mouse.
       After displaying a directory list, you can paste a filename to
       the command line in the form required by DOS using a double click
       followed by a single click (for confirmation).  WordGrab also
       works in a full-screen DOS session under Windows.

            This program is safe to run on a Pentium processor since it
       does not perform any floating-point divisions of large numbers.
       In addition, FileJockey Software does not release products with
       known bugs.

            If you decide to keep this program, paying the $30 license
       and registration fee will result in your receiving:

       1) a code to bypass the registration-reminder screen,
       2) WordGrab and maximizing-available-memory tips,
       3) technical support,
       4) notices of upgrades and bug fixes, and
       5) eligibility for a free upgrade.

       In addition, you will be promoting continuing product development
       and using this program legally.  Otherwise, you may not keep the
       individual files on your PC.  But, you may keep the .ZIP file.  A
       registration form containing my postal address is provided for
       you in the file WRDGRB.REG.  On CompuServe, you may GO SWREG
       (#5571) to register on-line.




            Please send comments, suggestions and problem reports to me
       at 71573,1023 by CompuServe e-mail, at 71573.1023@compuserve.com
       by Internet e-mail, or at my postal address, even if you are not
       currently a customer.  By the second quarter of 1996, my e-mail
       address will also be FileJockey@compuserve.com.

            WordGrab requires an installed mouse, DOS 3.3 or later, and
       a hard disk with drive letter C.  (It does not have to be
       installed on this disk.)


       II.  How to Use

       II.A.  Installing to Memory

       To install WordGrab, enter

                                    WRDGRB

       at the DOS prompt.  You may wish to install this program from
       your AUTOEXEC.BAT start-up file.  Do not install this program
       when you are using the go-to-DOS feature of an application
       program unless you remove WordGrab from memory before returning
       to that program.  See Appendix A for program options.


       II.B.  Unloading from Memory

       To remove WordGrab from memory, enter

                                   WRDGRB /U

       at the DOS prompt.  Then, WordGrab sends an unload/deactivate
       order to its in-memory copy, prints the first part of the status
       message:

                                 WRDGRB is ...

       and returns to the DOS prompt.  Within one second, the program
       will finish the status message with either "unloaded" or
       "trying".  "Trying" will be changed to either "unloaded" or
       "deactivated" within another 1 1/2 seconds, depending on whether
       or not any programs loaded after WordGrab are still in memory.

            If the "deactivated" message is printed and you still want
       to unload WordGrab, remove any subsequently loaded programs and
       issue the unload command again.  To reactivate the program, enter
       WRDGRB again.






                                    Page 2




       II.C.  At the DOS Screen

       When you see a filename, word or other text that you want to copy
       to the command line, press <Ctrl>-<Right shift>-W to activate
       WordGrab and the mouse cursor.  Use the mouse cursor as you
       normally would to highlight text.

            For example, position the cursor at the start of a word,
       press and hold down the left button, and drag the cursor to the
       right one space past the word.  As you do so, the word will be
       highlighted.  Release the mouse button.  At this point, you may
       type text to go before the highlighted word.  (You may also type
       text after activating WordGrab but before highlighting text.)

            Then, click the left mouse button to copy the selected text
       to the command line or the right button to cancel the selection.
       In either case, the highlighted text will be restored to how it
       was if you don't change its position by pressing <Enter>, for
       example.  If you double left or right click, the selection will
       be handled as above but the mouse cursor will re-appear to wait
       for another selection.  See the table below.


                             Left Button       |     Right Button
                      -------------------------------------------------
       Single click   |       send text        |        cancel        |
       ----------------------------------------------------------------
       Double click   |      send text &       |       cancel &       |
                      |   wait for more text   |  wait for more text  |
                      -------------------------------------------------


            You can also highlight an entire word at once by double
       left-clicking on it.  (A word is defined to be a sequence of
       valid DOS filename characters plus dot (.), question mark (?) and
       star (*).  See your DOS manual for a complete list.)  The mouse
       cursor jumps to one space past the word.  Then you can deselect
       characters from the end of the word by moving the mouse cursor
       back toward the beginning of the word while continuing to hold
       down the left mouse button.  Once you have double clicked on a
       word, you can highlight text to the right by continuing to hold
       down the left mouse button and dragging the mouse to the right.

            If you highlight a filename and its extension as part of a
       directory listing, WordGrab will send the name to the command
       line in the form FILENAME.EXT.  In other words, the intermediate
       space(s) will be changed to a single period.  One way to
       highlight a filename is to double-click on its basename -- the
       part before the dot and extension.  If you also highlight the
       space to the right of the file extension, that space will be




                                    Page 3




       copied to the command line.  This is useful for placing two or
       more filenames on the command line.

            WordGrab works in the 25 x 80, 43 x 80 and 50 x 80 text
       screen modes.


       II.D.  In a Windows 3.1 or Windows 95 DOS-Session

       WordGrab works in a full-screen Windows 3.1 or Windows 95 DOS-
       session.  However, you may need to add the line

                                MouseinDOSBox=1

       to the [NonWindowsApp] section of Windows's SYSTEM.INI file.  If
       you install WordGrab after starting Windows, be sure to remove it
       before closing the DOS window.


       II.E.  Copying to an Application Program

       Although WordGrab can be used with some application programs, it
       is not designed for this purpose.  When doing so, be careful not
       to press a mouse button until you are ready to send the
       highlighted text to the program.  In addition, you may need to
       press a shift key after sending text in order for the program to
       realize that there is keyboard input to read.

            Problems that may occur include your computer freezing if
       you later call WordGrab from DOS and losing the mouse cursor.  To
       restore the cursor, use the application-program's go-to-DOS
       feature and return (by entering EXIT).  The program should then
       redraw the screen and restore the mouse cursor.


       III. Free Upgrade Policy

       FileJockey Software will not charge an upgrade fee to registered
       users who provide a non-trivial suggestion or bug report that is
       implemented or fixed.  Excluded from this policy are suggestions
       to make the program smaller, faster or cheaper.  All policy
       decisions of FileJockey Software are final.

            The motivation for this policy is noticing that some
       software would be *just right* if only the author(s) made a few
       minor changes or bug fixes.  Wouldn't be nice if we could get
       slightly improved or fixed software without paying extra?  Now
       you can if you register FileJockey Software products.






                                    Page 4




       Appendices

       A.   Command Line Switches

       Entering
                                   WRDGRB /?

       produces the following summary of command line switches or
       options:

       WRDGRB [switches]

       /U             Unload WordGrab from memory
       /L             Allow including the last screen column
       /N             Do not print pop-up instructions
       /D:sss         Mouse double-click threshold (in 1/1000 seconds)
       /H:x           Hotkey letter to use with <Ctrl>-<Right shift>
       /R:nnnnn       Recognition code: choose a 5-digit whole number
                      < 32767
       /S             Display SiteCode (and re-write WRDGRB.REG)
       /I:initname    Alternate initialization filename (with path)
                      Follow /L or /N with '-' to override WRDGRB.INI
                      setting(s)

            When you highlight text, the mouse cursor position is
       normally not part of the selected text.  This prevents you from
       including characters in column 80 in the selected text.  If you
       think that you might want to include these characters, use the /L
       switch.  This causes WordGrab to include the following character
       whenever a column 79 character is highlighted.  If you set this
       feature to be on in WRDGRB.INI, you may use /L- to turn it off
       when loading WordGrab.

            The default double click threshold is 1/2 a second.  If
       within this time you click the same button twice, it will
       register as a double click.  You can change the threshold to a
       positive time delay less than 32.7 seconds.  For comparison,
       Windows 3.1's mouse dialog box allows thresholds between 0.1 and
       0.9 seconds with a default of 0.452 seconds.

            Since another TSR might use the same hot key sequence, the
       /H switch allows you to change the letter that you press along
       with <Ctrl> and <Right shift> to activate WordGrab.  Note that
       PCs distinguish between the right and left shift buttons under
       certain circumstances.  For more control over the hotkey
       sequence, see Appendix B.

            You will need to change WordGrab's or another TSR's
       recognition code if both use the same code and you wish to have
       both in memory at the same time.  This code is a number WordGrab
       stores in memory to prevent installing two copies of itself.  You



                                    Page 5




       will know that changing the code is necessary if either program
       incorrectly reports that it is already loaded.  Then, if you
       decide to change WordGrab's code, select any positive five-digit
       whole number less than 32,767 and try installing WordGrab with
       this number using the /R option.  If you changed the recognition
       code, you must tell WordGrab the new code when unloading the
       program.  Once a recognition code works for you, place it on the
       RecognitionCode= line of WRDGRB.INI.

            If you decide to load WordGrab when a list of files is
       already on the screen, use the /N switch to reduce the number of
       lines the screen will scroll.  In particular, WRDGRB/N does not
       print instructions for activating itself.  This setting can be
       placed in WRDGRB.INI and overridden by /N-.

            WordGrab will occasionally display a two-part registration-
       reminder screen when initializing unless you place the bypass
       code in the initialization file.  This code depends on another
       code, SiteCode, that appears on this screen.  In addition, the
       first screen contains a button to write WRDGRB.REG with your
       computer's SiteCode on the appropriate line.  To force this
       screen to appear, enter WRDGRB/S.  For more information, see
       Appendix C.

            The switch /I allows running WordGrab off a CD-ROM.  With
       it, the location of the initialization (.INI) file can be
       specified to be any write-able media, such as a hard disk.  Note
       that WordGrab requires that your computer have a hard disk with
       drive letter C.


       B.   Initialization File (WRDGRB.INI)

       As shipped, the initialization file looks like this:

       [Defaults]
       DoubleClick=
       LastColumn=
       HotToggle=
       HotLetter=
       RecognitionCode=
       NoInstructions=
       DblClkEntireName=

       [Registration]
       RegKey=
       Notified=NO

            Most of the items in the Defaults section correspond to
       command-line switches.  For LastColumn and NoInstructions, you
       can use a non-zero number, YES, Y, TRUE, T, or ON to select the



                                    Page 6




       feature.  When loading WordGrab, you can turn off these features
       by using /L- or /N-, respectively.  Briefly, the purpose of
       LastColumn is to allow including column 80 and the benefit of
       NoInstructions is to reduce the number of lines that scroll off
       the screen when WordGrab is loaded.

            Toggles consist of the <Ctrl>, <Alt>, <Left shift>, and
       <Right shift> keys.  The default toggles for WordGrab's hotkey
       sequence are <Ctrl> and <Right shift>.  To specify other ones,
       place one or more of the letters C, A, L, and R on the HotToggle=
       line.  To specify that no letter is to be used along with the
       toggle(s), put NONE on the HotLetter= line.  For example, using
       both shift keys without a letter is specified by the following
       settings:

                                 HotToggle=LR
                                HotLetter=NONE

            The DblClkEntireName entry specifies whether or not to
       select an entire filename when its basename is double clicked in
       a directory listing.  (Basename is the part of a filename before
       the optional dot and extension.)  If the entire filename is
       selected, clicking on the left mouse button will place it on the
       command line in the DOS-usable form (FILENAME.EXT).

            In order to turn off the registration-reminder screen (see
       Appendix C), you need to place the correct code after the equal
       sign on the "RegKey=" line.  This code depends on information
       about your computer that is summarized in a SiteCode.

            Once you place a code on that line, the program will test it
       and tell you whether or not it is correct.  Afterwards, Notified
       will be set to YES.  This feature is useful since the random
       occurrences of the registration-reminder screen prevent easily
       determining if the registration key is correct.

            The program will look for WRDGRB.INI in the same directory
       containing WRDGRB.EXE and WGINIT.EXE (unless you use the /I
       switch).  If it doesn't find this file, it will give you the
       option of either editing the path and filename or not reading it.


       C.  Registration-Reminder Screen

       To inspire you to register WordGrab, the program may display a
       two-part reminder screen before it finishes initializing itself.
       This screen will not appear every time since its use is affected
       by a random-number generator.  Registered users can bypass this
       screen with the system-specific registration key (RegKey).  The
       key for your computer depends on a four-character code (SiteCode)
       that is printed on the first screen.  SiteCodes are not affected



                                    Page 7




       by installing or deleting programs, creating or deleting files,
       or changing configuration files.

            One of the buttons on the first screen will produce a
       version of WRDGRB.REG that contains your SiteCode.  To force this
       screen to appear, enter WRDGRB/S.  Selecting the Continue button
       will usually display a second screen in which you signal your
       understanding of the shareware concept by typing the displayed
       word, such as AGREE.  (Your typing will appear in upper case.)

            As part of the response to your payment and SiteCode, you
       will receive the appropriate RegKey by e-mail or postal mail,
       depending on whether or not you include an e-mail address.  Place
       this key on the "RegKey=" line of WRDGRB.INI.


       D.   Troubleshooting

       WordGrab Cannot Initialize Itself:

       WordGrab calls WGINIT.EXE for initialization in order to reduce
       its permanent memory needs.  WGINIT.EXE must be in the same
       directory as WRDGRB.EXE.  You may need to extract WGINIT.EXE from
       WRDGRB.ZIP or copy it from where it is stored.


       ^W Appears When I Try to Activate WordGrab:

       If WordGrab is loaded, make sure you are pressing the <Right
       shift> key along with a <Ctrl> key and the hotkey letter.  If you
       forgot the hotkey letter or sequence, enter WRDGRB/N-.  It will
       not load another copy of itself (unless you have changed its
       recognition code with the /R switch or RecognitionCode= in
       WRDGRB.INI).  Instead, it will re-activate the mouse and remind
       you of the hotkey sequence.  If you are not certain if WordGrab
       is loaded, enter WRDGRB/N-.  Or, you could use the DOS MEM
       command (DOS 4.0 or later) or a system-information utility to
       list your memory resident or TSR programs.


       WordGrab is Loaded But I Cannot Find the Mouse Cursor:

       Try moving the mouse around.  Try entering WRDGRB/N-.  If those
       approaches don't work, you may need to unload WordGrab and reload
       it.  On rare occasions, it may be necessary to reboot your
       computer.








                                    Page 8




       E.   Other FileJockey Software Products

       Following is a list of current FileJockey Software products.  All
       of the compressed files for these products have extension ZIP.
       In parentheses after the descriptions are the locations where the
       programs may be found on CompuServe and the registration/license
       fees.


       E.1.  System Tools (DOS)

       LISTRS 1.2 -- Directory/Program List Makers With Action Options:

       DIRLIST: More accurate than "dir *."  Options include show files,
       change to and remove directory.  PROGLIST: Shows a directory's
       .EXE, .COM and .BAT files in one listing to help users find the
       name of the program file to run.  Options include type & run,
       type & wait and edit .BAT files with a user-selected editor.
       Both programs correctly sort numbers within filenames.  No known
       bugs.  (GO PCUTIL, Library 5, $15)
       ** Plans for next version: ignoring long-filename directory
       entries and excluding Windows .EXE files.


       C2DD 1.0 -- Change to Drive/Directory and Back

       This program changes the current drive/directory to a specified
       pair and records path information for moving back to any of
       several previous drive/directories.  It can move back one pair at
       a time or present a graphical pick list.  C2DD can be used with
       any DOS directory navigator and is useful for returning to the
       starting drive/directory in batch (.BAT) files.  No known bugs.
       Free program by FileJockey Software.  (GO PCUTIL, Library 1, $0)
       ** Plans for next version: adding mouse support and a program to
       store the current path in an environment variable without running
       a secondary batch file.


       E.2.  Programmer Tools (DOS, Windows)

       YEARIN 1.0 -- Handles 2-Digit Year Input for Beyond 1999

       YEARIN demonstrates a routine that properly handles two-digit
       year inputs now and will do so in the 21st century.  For example,
       98 converts to 1998 and 3 becomes 2003, regardless of when in the
       next few decades those numbers are entered.  Also enclosed is a
       free Microsoft C/C++ .OBJ file containing this routine.  YEARIN
       requires Windows 3.1 or higher.  Free program by FileJockey
       Software.  (GO PCPROG, Library 8, $0)





                                    Page 9




       SRLIB 1.1 -- LIB: Alphanumeric Filename Sorting:

       SRLIB is a set of library routines to sort filenames
       alphanumerically.  For example, it places FILE_2 before FILE_10
       and can handle long file names, leading zeros and spaces.  SRLIB
       is compiled for Microsoft C/C++'s and Borland TC++'s small and
       large memory models.  (See SRDEMO in MSLANG, Lib. 3.)  New: case-
       insensitive routine, 3rd space-handling option, commas-within-
       numbers handling, and more.  SRDEMO.C, included in SRLIB.ZIP,
       reads a directory once even for an unknown number of files.  GO
       SWREG (#5947) to purchase SRLIB on-line.  Site licenses and
       source code are available.  No known bugs.  ($24 plus $1 S/H (by
       e-mail) or $24 plus CA tax plus $4 S/H (by disk))
       ** Plans for next version: Windows-based demo.  (This product
       might be renamed and stored in a different location.)


       PROGCR 1.0 -- Prepares Programs for Copyrighting:

       Protects the privacy of your C/C++ or PASCAL source code
       copyright deposit by removing comments after each file's header
       (which should primarily consist of your copyright notice) from
       copies of the original files.  Also, copies words displayed by
       standard or user-specified print commands to a file for spell
       checking.  (GO PCPROG, Library 6, $10)
       ** Plans for next version: making it Windows based, adding an
       option to create only the spell-check file, and including better
       file-extension mapping to file types.


       E.3.  BBS-Session Tools (DOS)

       FRMDSK 1.1 -- Enters Text From Disk With Line Preview & Edit:

       Use FRMDSK when BBS software (or another program) requires you to
       type in text instead of allowing you to upload a file.  It copies
       lines from a file to your program after giving you preview, edit,
       and other options.  Works only with DOS text programs that use
       standard keyboard reading, such as VendEdit (mentioned with
       permission).  New features include: safe command-line unloading
       and selectable hotkey sequence.  Free upgrade for implemented
       significant suggestions or bug fixes.  37K or 63K TSR.
       FileJockey shareware.  (GO PCCOM, Library 2, $5)


       CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files:

       Prepares BBS capture files for editing by removing page pause
       lines ("Press <CR> for more !", etc.) and word-wrapping various
       types of paragraphs (including each line starting with ">>" and
       indented paragraphs).  Many page pause lines are in a user-



                                    Page 10




       changeable .INI file.  Version 1.1 improvements include multi-BBS
       support and better word wrapping.  (GO PCCOM, Library 2, $5)


       F.   License Agreement

       This is a legal agreement between you ("Licensee") and FileJockey
       Software ("Licensor").  Licensor owns all worldwide rights,
       title, copyright and other interests in and to the computer
       program identified as WRDGRB 1.3 ("Software").  By using the
       Software, you are agreeing to be bound by the following terms:

       1.   Licensor grants to Licensee the non-exclusive and non-
       assignable right to use the Software for a period of 30 days
       without paying a fee to Licensor.  After 30 days, Licensee may
       continue this right by paying $30 to Licensor.

       2.   Licensee may distribute copies of the Software and related
       files to others provided Licensee informs the recipients that the
       Software is subject to a license agreement and that the fee you
       charge, if any, does not include the license fee.  The attached
       VENDINFO data record is hereby incorporated by reference.  Any
       distribution satisfying all the distribution requirements
       expressed in that data record is hereby authorized.

       3.   Licensor hereby alerts Licensee that the Software and
       accompanying documentation are provided "AS IS" without warranty
       of any kind.  Licensee assumes all risks involving use of the
       Software and its results and performance.

       4.   Licensee hereby acknowledges that Licensor bears no
       responsibility or liability which may arise or result from
       Licensee's use of the Software.  Licensee hereby waives and
       releases Licensor from any and all claims for damages, losses and
       costs therefrom.  In no event shall Licensor's liability for any
       damages ever exceed the price paid for license and registration,
       regardless of the form of the claim.

       5.   This license agreement shall be construed and enforced in
       accordance with the laws of the State of California.  This
       agreement may not be modified except by written instrument signed
       by both parties.  If any provisions of this agreement are found
       to be invalid or unenforceable by the operation of the law, then
       invalidity or unenforceability of such provision(s) shall not
       affect the validity or enforceability of the other provisions of
       this agreement.  Any dispute arising from this agreement shall be
       submitted to California courts located in Los Angeles County, and
       Licensee hereby submits to the jurisdiction of such courts.


       All (registered) trademarks and (registered) service marks are
       properties of their respective companies.


                                    Page 11

