home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 25 / CD_ASCQ_25_1095.iso / dos / tools / wrdgrb11 / wrdgrb.txt < prev   
Text File  |  1995-08-12  |  22KB  |  527 lines
  1.  
  2.  
  3.  
  4.                                   WRDGRB 1.1
  5.                  Copies Words From DOS Screen to Command Line
  6.                    Copyright (c) 1995 by David M. Wincelberg
  7.  
  8.  
  9.                                Table of Contents
  10.  
  11.        I.   Introduction ............................................  1
  12.        II.  How to Use ..............................................  2
  13.  
  14.        Appendices:
  15.  
  16.        A.   Command Line Switches ...................................  4
  17.        B.   Initialization File (WRDGRB.INI) ........................  5
  18.        C.   Registration Reminder Screen ............................  6
  19.        D.   Troubleshooting .........................................  7
  20.        E.   Other FileJockey Software Products ......................  7
  21.        F.   License Agreement .......................................  9
  22.  
  23.  
  24.        I.   Introduction
  25.  
  26.        Thank you for trying WRDGRB.  With WRDGRB installed, you will no
  27.        longer type words or other text you see on the DOS screen!
  28.        Instead, you will press the hot-key sequence, highlight text with
  29.        your mouse, and left click to copy it to the command line (or
  30.        right click to cancel).  WRDGRB even connects a filename to its
  31.        extension when both are highlighted in a directory listing.
  32.  
  33.             This 23K memory resident or terminate and stay resident
  34.        (TSR) program is safe to run on a Pentium processor since it does
  35.        not perform any floating point divisions of large numbers.  In
  36.        addition, FileJockey Software does not release products with
  37.        known bugs.
  38.  
  39.             If you decide to keep this program, paying the $35 license
  40.        and registration fee will result in your receiving:
  41.  
  42.        1) WRDGRB and maximizing-available-memory tips,
  43.        2) technical support,
  44.        3) notices of updates and bug fixes, and
  45.        4) a code to bypass the registration reminder screen.
  46.  
  47.        In addition, you will be promoting continuing product development
  48.        and using this program legally.  Otherwise, you may not keep the
  49.        individual files on your PC.  But, you may keep the .ZIP file.  A
  50.        registration form containing my postal address is provided for
  51.        you in the file WRDGRB.REG.
  52.  
  53.             Send comments, suggestions and problem reports to me at
  54.        71573,1023 by CompuServe e-mail, at 71573.1023@compuserve.com by
  55.  
  56.  
  57.  
  58.  
  59.        Internet e-mail, or at my postal address.  I plan to read each
  60.        one, but, if I receive a large amount of mail, I may not be able
  61.        to reply to each letter.
  62.  
  63.             WRDGRB requires an installed mouse and DOS 3.0 or later.
  64.  
  65.  
  66.        II.  How to Use
  67.  
  68.        II.A.  Installing to Memory
  69.  
  70.        To install WRDGRB, enter
  71.  
  72.                                     WRDGRB
  73.  
  74.        at the DOS prompt.  You may wish to install this program from
  75.        your AUTOEXEC.BAT start-up file.  Do not install this program
  76.        when you are using the go-to-DOS feature of an application
  77.        program unless you remove WRDGRB from memory before returning to
  78.        the application program.  See Appendix A for program options.
  79.  
  80.  
  81.        II.B.  Unloading from Memory
  82.  
  83.        To remove WRDGRB from memory, enter
  84.  
  85.                                    WRDGRB /U
  86.  
  87.        at the DOS prompt.  Then, WRDGRB sends an unload/deactivate order
  88.        to its in-memory copy, prints the first part of the status
  89.        message:
  90.  
  91.                                  WRDGRB is ...
  92.  
  93.        and returns to the DOS prompt.  Within one second, the TSR will
  94.        finish the status message with either "unloaded" or "trying".
  95.        "Trying" will be changed to either "unloaded" or "deactivated"
  96.        within another 1 1/2 seconds, depending on whether any programs
  97.        loaded after WRDGRB are still in memory.
  98.  
  99.             If the "deactivated" message is printed and you still want
  100.        to unload WRDGRB, remove any subsequently loaded programs and
  101.        issue the unload command again.  To reactivate the program, enter
  102.        WRDGRB again.
  103.  
  104.  
  105.        II.C.  At the DOS Screen
  106.  
  107.        When you see a filename, word or other text that you would like
  108.        to copy to the command line, press <Ctrl>-<Right Shift>-W to
  109.  
  110.  
  111.  
  112.  
  113.                                     Page 2
  114.  
  115.  
  116.  
  117.  
  118.        activate WRDGRB and the mouse cursor.  Use the mouse cursor as
  119.        you normally would to highlight text.
  120.  
  121.             For example, position the cursor at the start of a word,
  122.        press and hold down the left button, and drag the cursor to the
  123.        right one space past the word.  As you do so, the word will be
  124.        highlighted.  Release the mouse button.  At this point, you may
  125.        type text to go before the highlighted word.  (You may also type
  126.        text after activating WRDGRB but before highlighting text.)
  127.  
  128.             Then, click the left mouse button to copy the selected text
  129.        to the command line or the right button to cancel the selection.
  130.        In either case, the highlighted text will be restored to how it
  131.        was if you don't change its position by pressing <Enter>, for
  132.        example.  If you double left or right click, the selection will
  133.        be handled as above but the mouse cursor will re-appear to wait
  134.        for another selection.  See the table below.
  135.  
  136.  
  137.                              Left Button       |     Right Button
  138.                       -------------------------------------------------
  139.        Single click   |       send text        |        cancel        |
  140.        ----------------------------------------------------------------
  141.        Double click   |      send text &       |       cancel &       |
  142.                       |   wait for more text   |  wait for more text  |
  143.                       -------------------------------------------------
  144.  
  145.  
  146.             You can also highlight an entire word at once by double
  147.        left-clicking on it.  (A word is defined to be a sequence of
  148.        valid DOS filename characters plus dot (.), question mark (?) and
  149.        star (*).  See your DOS manual for a complete list.)  Once you
  150.        have double clicked on a word, you can continue to highlight text
  151.        to the right by holding down the left mouse button and dragging
  152.        the mouse to the right.
  153.  
  154.             If you highlight a filename and its extension as part of a
  155.        directory listing, WRDGRB will send the name to the command line
  156.        in the form FILENAME.EXT.  In other words, the intermediate
  157.        space(s) will be changed to a single period.
  158.  
  159.             WRDGRB works in the 25 x 80, 43 x 80 and 50 x 80 text screen
  160.        modes.
  161.  
  162.  
  163.        II.D.  In a Windows 3.1 DOS Box
  164.  
  165.        WRDGRB works in a full screen Windows 3.1 DOS window.  However,
  166.        you may need to add the line
  167.  
  168.                                 MouseinDOSBox=1
  169.  
  170.  
  171.  
  172.                                     Page 3
  173.  
  174.  
  175.  
  176.  
  177.        to the [NonWindowsApp] section of Windows 3.1's SYSTEM.INI file.
  178.        If you install WRDGRB after starting Windows, be sure to remove
  179.        it before closing the DOS window.
  180.  
  181.  
  182.        II.E.  Copying to an Application Program
  183.  
  184.        Although WRDGRB can be used with some application programs, it is
  185.        not designed for this purpose.  When doing so, be careful not to
  186.        press a mouse button until you are ready to send the highlighted
  187.        text to the program.  In addition, you may need to press a shift
  188.        key after sending text in order for the program to realize that
  189.        there is keyboard input to read.
  190.  
  191.             Problems that may occur include your computer freezing if
  192.        you later call WRDGRB from DOS and losing the mouse cursor.  To
  193.        restore the cursor, use the application program's go-to-DOS
  194.        feature and return (by entering EXIT).  The program should then
  195.        redraw the screen and restore the mouse cursor.
  196.  
  197.  
  198.        Appendices
  199.  
  200.        A.   Command Line Switches
  201.  
  202.        Entering
  203.                                    WRDGRB /?
  204.  
  205.        produces the following summary of command line switches or
  206.        options:
  207.  
  208.        WRDGRB [switches]
  209.  
  210.        /U        Unload WRDGRB from memory
  211.        /L        Allow including the last screen column
  212.        /N        Do not print pop-up instructions
  213.        /D:sss    Mouse double click threshold (in 1/1000 seconds)
  214.        /H:x      Hot key letter to use with <Ctrl>-<Right shift>
  215.        /R:nnnnn  Recognition code: choose a 5 digit whole number < 32767
  216.        /S        Display SiteCode (and re-write WRDGRB.REG)
  217.                  Follow /L or /N with '-' to override WRDGRB.INI
  218.                  setting(s)
  219.  
  220.             When you highlight text, the mouse cursor position is
  221.        normally not part of the selected text.  This prevents you from
  222.        including characters in column 80 in the selected text.  If you
  223.        think that you might want to include these characters, use the /L
  224.        switch.  This causes WRDGRB to include the following character
  225.        whenever a column 79 character is highlighted.  If you set this
  226.  
  227.  
  228.  
  229.  
  230.                                     Page 4
  231.  
  232.  
  233.  
  234.  
  235.        feature to be on in WRDGRB.INI, you may use /L- to turn it off
  236.        when loading WRDGRB.
  237.  
  238.             The default double click threshold is 1/2 a second.  If
  239.        within this time you click the same button twice, it will
  240.        register as a double click.  You can change the threshold to a
  241.        positive time delay less than 32.7 seconds.  For comparison,
  242.        Windows 3.1's mouse dialog box allows thresholds between 0.1 and
  243.        0.9 seconds with a default of 0.452 seconds.
  244.  
  245.             Since another TSR might choose the same hot key sequence,
  246.        the /H switch allows you to change the letter that you press
  247.        along with <Ctrl> and <Right shift> to activate WRDGRB.  Note
  248.        that PCs distinguish between the right and left shift buttons
  249.        under certain circumstances.
  250.  
  251.             You will need to change WRDGRB's or another TSR's
  252.        recognition code if both use the same code and you wish to have
  253.        both in memory at the same time.  This code is a number WRDGRB
  254.        stores in memory to prevent installing two copies of itself.  You
  255.        will know that changing the code is necessary if either program
  256.        incorrectly reports that it is already loaded.  Then, if you
  257.        decide to change WRDGRB's code, select any positive five digit
  258.        whole number less than 32,767 and try installing WRDGRB with this
  259.        number using the /R option.  If you changed the recognition code,
  260.        you must tell WRDGRB the new code when unloading the program.
  261.        Once a recognition code works for you, place it on the
  262.        RecognitionCode= line of WRDGRB.INI.
  263.  
  264.             If you decide to load WRDGRB when a list of files is already
  265.        on the screen, use the /N switch to reduce the number of lines
  266.        the screen will scroll.  In particular, WRDGRB/N does not print
  267.        instructions for activating itself.  This setting can be placed
  268.        in WRDGRB.INI and overridden by /N-.
  269.  
  270.             WRDGRB will occasionally display a registration-reminder
  271.        screen when initializing unless you place the bypass code in the
  272.        initialization file.  This code depends on another code
  273.        (SiteCode) that appears on this screen.  In addition, this screen
  274.        contains a button to write WRDGRB.REG with your computer's
  275.        SiteCode on the appropriate line.  To force this screen to
  276.        appear, enter WRDGRB/S.  For more information, see Appendix C.
  277.  
  278.  
  279.        B.   Initialization File (WRDGRB.INI)
  280.  
  281.        As shipped, the initialization file looks like this:
  282.  
  283.        [Defaults]
  284.        DoubleClick=
  285.        LastColumn=
  286.  
  287.  
  288.  
  289.                                     Page 5
  290.  
  291.  
  292.  
  293.  
  294.        HotLetter=
  295.        RecognitionCode=
  296.        NoInstructions=
  297.  
  298.        [Registration]
  299.        RegKey=
  300.        Notified=NO
  301.  
  302.             The items in the Defaults section correspond to command-line
  303.        switches.  For LastColumn and NoInstructions, you can use a non-
  304.        zero number, YES, Y, TRUE, T, or ON to select the feature.  When
  305.        loading WRDGRB, you can turn off these features by using /L- or
  306.        /N-, respectively.  Briefly, the purpose of LastColumn is to
  307.        allow including column 80 and the benefit of NoInstructions is to
  308.        reduce the number of lines that scroll off the screen when WRDGRB
  309.        is loaded.
  310.  
  311.             In order to turn off the registration-reminder screen (see
  312.        Appendix C), you need to place the correct code after the equal
  313.        sign on the "RegKey=" line.  This code depends on information
  314.        about your computer that is summarized in a SiteCode.
  315.  
  316.             Once you place a code on that line, the program will test it
  317.        and tell you whether or not it is correct.  Afterwards, Notified
  318.        will be set to YES.  This feature is useful since the random
  319.        occurrences of the registration-reminder screen prevent easily
  320.        determining if the registration key is correct.
  321.  
  322.             The program will look for WRDGRB.INI in the same directory
  323.        containing WRDGRB and WGINIT.  If it doesn't find this file, it
  324.        will give you the option of either editing the path and filename
  325.        or not reading it.
  326.  
  327.  
  328.        C.  Registration-Reminder Screen
  329.  
  330.        To inspire you to register WRDGRB, the program may display a
  331.        reminder screen before it finishes initializing itself.  This
  332.        screen will not appear every time since its use is affected by a
  333.        random number generator.  Registered users can bypass this screen
  334.        with the system-specific registration key (RegKey).  The key for
  335.        your computer depends on a four-character code (SiteCode) that is
  336.        printed on this screen.  SiteCodes are not affected by installing
  337.        or deleting programs, creating or deleting files, or changing
  338.        configuration files.
  339.  
  340.             One of the buttons on this screen will produce a version of
  341.        WRDGRB.REG that contains your SiteCode.  To force this screen to
  342.        appear, enter WRDGRB/S.
  343.  
  344.  
  345.  
  346.  
  347.  
  348.                                     Page 6
  349.  
  350.  
  351.  
  352.  
  353.             As part of the response to your payment and SiteCode, you
  354.        will receive the appropriate RegKey by e-mail or postal mail,
  355.        depending on whether or not you include an e-mail address.  Place
  356.        this key on the "RegKey=" line of WRDGRB.INI.
  357.  
  358.  
  359.        D.   Troubleshooting
  360.  
  361.        WRDGRB Cannot Initialize Itself:
  362.  
  363.        WRDGRB calls WGINIT.EXE for initialization in order to reduce its
  364.        permanent memory needs.  WGINIT.EXE must be in the same directory
  365.        as WRDGRB.EXE.  You may need to extract WGINIT.EXE from
  366.        WRDGRB.ZIP or copy it from where it is stored.
  367.  
  368.  
  369.        ^W Appears When I Try to Activate WRDGRB:
  370.  
  371.        If WRDGRB is loaded, make sure you are pressing the <Right Shift>
  372.        key along with a <Ctrl> key and the hot-key letter.  If you
  373.        forgot the hot-key letter, enter WRDGRB/N-.  It will not load
  374.        another copy of itself (unless you have changed its recognition
  375.        code with the /R switch or RecognitionCode= in WRDGRB.INI).
  376.        Instead, it will re-activate the mouse and remind you of the hot-
  377.        key sequence.  If you are not certain if WRDGRB is loaded, enter
  378.        WRDGRB/N-.  Or, you could use the DOS MEM command (DOS 4.0 or
  379.        later) or a system information utility to list your memory
  380.        resident or TSR programs.
  381.  
  382.  
  383.        WRDGRB is Loaded But I Cannot Find the Mouse Cursor:
  384.  
  385.        Try moving the mouse around.  Try entering WRDGRB/N-.  If those
  386.        don't work, you may need to unload WRDGRB and reload it.  On rare
  387.        occasions, it may be necessary to reboot your computer.
  388.  
  389.  
  390.        E.   Other FileJockey Software Products
  391.  
  392.        Following is a list of current FileJockey Software products.  All
  393.        of the compressed files for these products have extension ZIP.
  394.        In parentheses after the descriptions are the locations where the
  395.        programs may be found on CompuServe and the registration/license
  396.        fees.
  397.  
  398.  
  399.        E.1.  System Tool
  400.  
  401.        LISTRS 1.1 -- Directory/Program List Makers With Action Options:
  402.  
  403.  
  404.  
  405.  
  406.  
  407.                                     Page 7
  408.  
  409.  
  410.  
  411.  
  412.        DIRLIST: More accurate than "dir *."  Options include show files,
  413.        change to and remove directory.  PROGLIST: Shows a directory's
  414.        .EXE, .COM and .BAT files in one listing to help users find the
  415.        name of the program file to run.  Options include type & run,
  416.        type & wait and edit .BAT files with a user-selected editor.
  417.        Both programs correctly sort numbers within filenames.  Pentium
  418.        safe.  No known bugs.  (GO PCUTIL, Library 5, $15)
  419.  
  420.  
  421.        E.2.  Programmer Tools
  422.  
  423.        SRLIB 1.01 -- LIB: Sorting Filenames Containing Digits:
  424.  
  425.        SRLIB is a set of library routines to sort filenames that may
  426.        contain digits.  For example, it places FILE2 before FILE10.  It
  427.        can handle long file names and is compiled for Microsoft C 6.0,
  428.        C 7.0, and VC++ 1.x for the small and large memory models.
  429.        SRDEMO.C, included in SRLIB.ZIP, reads a directory once even for
  430.        an unknown number of files.  GO SWREG (#5947) to purchase SRLIB
  431.        on-line.  Pentium safe.  No known bugs.  ($24 plus $1 S/H (by e-
  432.        mail) or $24 plus CA tax plus $4 S/H (by disk))
  433.  
  434.  
  435.        PROGCR 1.0 -- Prepares Programs for Copyrighting:
  436.  
  437.        Protects the privacy of your C/C++ or PASCAL source code
  438.        copyright deposit by removing comments after each file's header
  439.        (which should primarily consist of your copyright notice) from
  440.        copies of the original files.  Also, copies words displayed by
  441.        standard or user-specified print commands to a file for spell
  442.        checking.  Pentium safe.  (GO PCPROG, Library 6, $10)
  443.  
  444.  
  445.        E.3.  BBS-Session Tools
  446.  
  447.        CFWRAP 1.1 -- Word Wrapping Tuned for BBS Capture Files:
  448.  
  449.        Prepares BBS capture files for editing by removing page pause
  450.        lines ("Press <CR> for more !", etc.) and word-wrapping various
  451.        types of paragraphs (including each line starting with ">>" and
  452.        indented paragraphs).  Many page pause lines are in a user-
  453.        changeable .INI file.  Version 1.1 improvements include multi-BBS
  454.        support and better word wrapping.  Pentium safe.  (GO PCCOM,
  455.        Library 2, $15)
  456.  
  457.  
  458.        FRMDSK 1.0 -- Enters Text From Disk With Line Preview & Edit:
  459.  
  460.        Use FRMDSK when a BBS requires you to type in lines instead of
  461.        allowing you to upload a file.  It copies lines from a file to
  462.        your BBS software (or other program) after giving you options.
  463.  
  464.  
  465.  
  466.                                     Page 8
  467.  
  468.  
  469.  
  470.  
  471.        These options include edit line, finish file, wait, cancel,
  472.        next/previous line and another file.  Works only with DOS text
  473.        programs that read the keyboard in the standard way.  Pentium
  474.        safe 66K TSR.  (GO PCCOM, Library 2, $15)
  475.  
  476.  
  477.        F.   License Agreement
  478.  
  479.        This is a legal agreement between you ("Licensee") and FileJockey
  480.        Software ("Licensor").  Licensor owns all worldwide rights,
  481.        title, copyright and other interests in and to the computer
  482.        program identified as WRDGRB 1.1 ("Software").  By using the
  483.        Software, you are agreeing to be bound by the following terms:
  484.  
  485.        1.   Licensor grants to Licensee the non-exclusive and non-
  486.        assignable right to use the Software for a period of 30 days
  487.        without paying a fee to Licensor.  After 30 days, Licensee may
  488.        continue this right by paying $35 to Licensor.
  489.  
  490.        2.   Licensee may distribute copies of the Software and related
  491.        files to others provided Licensee informs the recipients that the
  492.        Software is subject to a license agreement and that the fee you
  493.        charge, if any, does not include the license fee.
  494.  
  495.        3.   Licensor hereby alerts Licensee that the Software and
  496.        accompanying documentation are provided "AS IS" without warranty
  497.        of any kind.  Licensee assumes all risks involving use of the
  498.        Software and its results and performance.
  499.  
  500.        4.   Licensee hereby acknowledges that Licensor bears no
  501.        responsibility or liability which may arise or result from
  502.        Licensee's use of the Software.  Licensee hereby waives and
  503.        releases Licensor from any and all claims for damages, losses and
  504.        costs therefrom.  In no event shall Licensor's liability for any
  505.        damages ever exceed the price paid for license and registration,
  506.        regardless of the form of the claim.
  507.  
  508.        5.   This license agreement shall be construed and enforced in
  509.        accordance with the laws of the State of California.  This
  510.        agreement may not be modified except by written instrument signed
  511.        by both parties.  If any provisions of this agreement are found
  512.        to be invalid or unenforceable by the operation of the law, then
  513.        invalidity or unenforceability of such provision(s) shall not
  514.        affect the validity or enforceability of the other provisions of
  515.        this agreement.  Any dispute arising from this agreement shall be
  516.        submitted to California courts located in Los Angeles County, and
  517.        Licensee hereby submits to the jurisdiction of such courts.
  518.  
  519.  
  520.        All (registered) trademarks and (registered) service marks are
  521.        properties of their respective companies.
  522.  
  523.  
  524.  
  525.                                     Page 9
  526.  
  527.