


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


                               Table of Contents

       I.   Introduction ............................................  1
       II.  How to Use ..............................................  2

       Appendices:

       A.   Command Line Switches ...................................  4
       B.   Other FileJockey Software Products ......................  5
       C.   License Agreement .......................................  6


       I.   Introduction

       Thank you for trying WRDGRB.  With WRDGRB installed, you will no
       longer type words you see on the DOS screen!  Instead, you will
       press the hot-key sequence, highlight text with your mouse, and
       left click to copy it to the command line (or right click to
       cancel).  WRDGRB even connects a filename to its extension when
       both are highlighted in a directory listing.

            This 42K memory resident or terminate and stay resident
       (TSR) program is safe to run on a Pentium processor since it does
       not perform any floating point divisions of large numbers.

            If you decide to keep this program after 30 days, you are
       required to pay the $25 license and registration fee in order to
       use this program legally, receive technical support, promote
       future product development, and be notified of updates and bug
       fixes.  (FileJockey Software does not release products with known
       bugs.)  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.

            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.  I plan to read each
       one, but, if I receive a large amount of mail, I may not be able
       to reply to each letter.

            WRDGRB requires an installed mouse and DOS 2.1 or higher.



       II.  How to Use

       II.A.  Installing to Memory

       To install WRDGRB, 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 WRDGRB from memory before returning to
       the application program.  See Appendix A for program options.


       II.B.  Unloading from Memory

       To remove WRDGRB from memory, enter
                                   WRDGRB /U
       at the DOS prompt.  Then, WRDGRB 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 two seconds, the TSR will
       finish the status message with either "unloaded" or
       "deactivated," depending on whether any programs loaded after
       WRDGRB are still in memory.

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


       II.C.  At the DOS Screen

       When you see a filename, word or other text that you would like
       to copy to the command line, press <Ctrl>-<Right Shift>-W to
       activate WRDGRB 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 WRDGRB 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



                                    Page 2



       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.)  Once you
       have double clicked on a word, you can continue to highlight text
       to the right by holding 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, WRDGRB 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.

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


       II.D.  In a Windows 3.1 DOS Box

       WRDGRB works in a full screen Windows 3.1 DOS window.  However,
       you may need to add the line
                                MouseinDOSBox=1
       to the [NonWindowsApp] section of Windows 3.1's SYSTEM.INI file.
       If you install WRDGRB after starting Windows, be sure to remove
       it before closing the DOS window.


       II.E.  Copying to an Application Program

       Although WRDGRB 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.  In addition, you may need to press a shift key after
       sending text in order for the application program to realize that
       there is keyboard input to read.

            Problems that may occur include your computer freezing if
       you later call WRDGRB from DOS and losing the mouse cursor.  To



                                    Page 3



       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 cursor.


       Appendices

       A.   Command Line Switches

       Entering
                                   WRDGRB /?
       produces the following summary of command line switches or
       options:

       WRDGRB [switches]

       /U       Unload WRDGRB
       /D:s.s   Mouse double click threshold (in seconds)
       /L       Allow including the last screen column
       /H:x     Hot key letter to use with <Ctrl>-<Right shift>
       /R:nnnn  Recognition code: choose a 5 digit whole number < 32,767

            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 any
       positive number.  For comparison, Windows 3.1 allows thresholds
       between 0.1 and 0.9 seconds.

            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 will cause WRDGRB to include the following
       character whenever a column 79 character is highlighted.

            Since another TSR might choose 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 WRDGRB.  Note
       that PCs distinguish between the right and left shift buttons
       under certain circumstances.

            You will need to change WRDGRB'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 WRDGRB
       stores in memory to prevent installing two copies of itself.  You
       will know that changing the code is necessary if either program
       incorrectly reports that it is already loaded.  Then, if you
       decide to change WRDGRB's code, select any positive five digit
       whole number less than 32,767 and try installing WRDGRB with this
       number using the /R option.




                                    Page 4



            If you changed the recognition code, you must tell WRDGRB
       the new code when unloading or reactivating the program.


       B.   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.


       1.   Cyberspace/CompuServe Tools

       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-
       changeable .INI file.  Version 1.1 improvements include multi-BBS
       support, better word wrapping, dialog boxes and mouse support.
       Pentium safe.  (GO PCCOM, Library 2, $15)


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

       Use FRMDSK when a BBS requires you to type in lines instead of
       allowing you to upload a file.  It copies lines from a file to
       your BBS software (or other program) after giving you options.
       These options include edit line, finish file, wait, cancel,
       next/previous line and another file.  Works only with DOS text
       programs that read the keyboard in the standard way.  Pentium
       safe 66K TSR.  (GO PCCOM, Library 2, $15)


       2.   Programmer Tool

       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.  Pentium safe.  (GO PCPROG, Library 6, $10)







                                    Page 5



       3.   System Tool

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

       DIRLIST: More accurate than "dir *."  Options include show files,
       change to and remove directory.
       PROGLIST: Shows current directory's .EXE, .COM and .BAT files in
       one listing to help you find the name of the program file to run.
       Options include type & run, type & wait and view/edit .BAT files.
       Both programs correctly sort numbers within filenames.  Pentium
       safe.  No known bugs.  (GO PCUTIL, Library 5, $10)


       C.   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.0 ("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 $25 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.

       3.   Licensor hereby alerts Licensee that the Software and
       accompanying documentation are provided "AS IS" without warranty
       of any kind.  Licensor 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



                                    Page 6



       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 7
