


                                  FRMDSK 1.1
                   Enters Lines From Disk With Preview & Edit
                Copyright (c) 1995-1996 by David M. Wincelberg


                               Table of Contents

       I.   Introduction ............................................  1
       II.  How to Use ..............................................  2
       III. Limits, Warnings and Notes ..............................  3
       IV.  Free Upgrade Policy .....................................  3

       Appendices:

       A.   Command Line Switches ...................................  4
       B.   Input-Screens' Options ..................................  5
       C.   Troubleshooting .........................................  7
       D.   Other FileJockey Software Products ......................  7
       E.   License Agreement .......................................  9


       I.   Introduction

            Thank you for trying FRMDSK.  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.
       It works only with DOS text programs that read the keyboard in
       the standard way, such as VendEdit (mentioned with permission).
       The way to tell if a program works with FRMDSK is to try them
       together.  New features include safe command-line unloading and a
       selectable hot-key sequence.  See WHATSNEW.TXT for more
       information.

            FRMDSK is a 63K memory resident or terminate and stay
       resident (TSR) program.  A smaller version, FDSMALL, uses 37K but
       does not allow for changing the text file once the program is
       installed.  These programs are safe to run on a Pentium processor
       since they do 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 these programs, paying the $5 license
       and registration fee will result in your receiving:

                              technical support,
                 e-mail notices of upgrades and bug fixes, and
               eligibility for a free upgrade (see Section IV).

       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 FRMDSK.REG.

            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.

            FRMDSK requires DOS 3.0 or higher and enough memory to hold
       it and your BBS software (or other program) simultaneously.


       II.  How to Use

            The first thing to do is to load FRMDSK into memory before
       running your BBS program.  Do not load FRMDSK while using your
       BBS program's go-to-DOS feature since doing so may freeze
       ("crash") your computer.  To load the program, enter

                                    FRMDSK

       from the DOS prompt.  Several switches are described in Appendix
       A.  Since FRMDSK is a large (63K) memory resident program, it is
       better not to load it from your AUTOEXEC.BAT.  Instead, you may
       wish to use a batch file to load FRMDSK, run your BBS program and
       unload FRMDSK.  (See Appendix A for a sample batch file.)

            Once you are using a BBS (or other) program and want to
       enter text from a file, press <Ctrl>-<Right shift>-F.  (Hold down
       the first two keys and tap the third.  Then release all three
       keys.)  The opening screen will ask you for a file name.  If you
       enter a name with one or more wild-card characters in it, such as
       *.TXT, you will be presented with a pick list.  Select a file or
       press <Esc>.  If you press <Esc>, the File Not Found screen pops
       up and you may then edit the file name.  This screen will also
       appear if you misspell the file name or specify a file that does
       not exist.  Options for all the various screens are described in
       Appendix B.  For now, notice that pressing <PgUp> restores the
       file name to what it was on the opening screen.

            Many of the screens use a line editor that can handle more
       than 80 characters by scrolling when the line becomes too long.
       This line editor starts in overtype mode.  Press <Insert> to
       toggle between overtype and insert mode and press <Esc> to clear
       the line.  Otherwise, the line editor should behave consistently
       with other line editors.

            Once a file is opened, you are presented with the Send This
       Line screen.  This screen has many options.  For now, notice that



                                    Page 2




       you may edit the line, go to the next or previous line, send the
       current or all subsequent lines, or switch to another file.
       Further details are in Appendix B.

            To use FDSMALL, enter

                               FDSMALL filename

       where filename must be a valid file-name.  This version of FRMDSK
       only displays the Send This Line and Edit Line screens since all
       of the other screens are primarily for file-name handling.


       III. Limits, Warnings and Notes

            FRMDSK has several limitations: file names, including the
       path, may be up to 127 characters long and file lines may be up
       to 132 characters long.  In addition, FRMDSK does not work with
       some DOS-based programs.  For example, FRMDSK along with MS-DOS
       EDIT 6.0 causes the computer to freeze.

            FRMDSK also does not work well with programs that do not
       read the keyboard in the standard way.  (Microsoft WORKS 3.0
       seems to be in this category.)  The only way to tell if FRMDSK
       works with a program is to try them together.  What may happen is
       that your program does not always finish reading keys from the
       keyboard.  A work around is to press a shift key or the right
       arrow key (and ignore the beep).  In addition, these programs
       might drop the second of two consecutive letters.  For example,
       spell may come out as "spel".

            FRMDSK waits for your program to finish reading the current
       line but cannot determine when it has finished processing the
       line.  So. FRMDSK waits a fixed amount of time that can be
       adjusted while the program is running.  To do so, press 'D' for
       "change line-send Delay" and enter a new value in timer ticks
       (1/18 seconds).  You may also press 'W', allow to allow you
       program to finish, and then pop-up FRMDSK to continue where it
       left off.


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



                                    Page 3




       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.


       Appendices

       A.   Command Line Switches

       Entering FRMDSK /? produces the following summary of command line
       switches.  (FDSMALL's summary does not have brackets around
       filename since it is a required parameter.)

       FRMDSK [filename] [switches]

       filename       Initial file to read
       /U             Unload FRMDSK from memory
       /H:x           Hot-key letter to use with <Ctrl>-<Right shift>
       /T:ssss        Toggle key(s) to use with hot-key letter (instead
                      of above)
       /D:nn          Delay in timer ticks (1/18 seconds) for sending
                      lines
       /R:nnnn        Recognition code: choose a 5 digit whole number
                      < 32,767

            Since FRMDSK is a memory resident or TSR (Terminate and Stay
       Resident) program, there needs to be a way to remove it from
       memory without rebooting (or resetting) your computer.  In fact,
       there are two ways: press <PgDn> when the opening screen presents
       that option or enter FRMDSK/U.  A sample batch file using FRMDSK
       with another program follows:

                                @ECHO OFF
                                C:
                                \FRMDSK\FRMDSK
                                CD \QMODEM
                                QMODEM
                                \FRMDSK\FRMDSK /U

            The default sequence for activating FRMDSK once it is loaded
       is to press and hold the <Ctrl> and <Right shift> keys, press the
       letter 'F' and then release all these keys.  This triple-key
       sequence was chosen since it is less likely to interfere with
       sequences used by other programs.  You can change the letter that
       you press along with <Ctrl> and <Right shift> by using the /H
       switch as in the following:

                                  FRMDSK /H:A

       You could also change the toggles (<Ctrl>, <Alt>, <Left shift>,
       and <Right shift> keys) that are to be pressed with the hot



                                    Page 4




       letter.  The default toggles for FRMDSK's hot-key sequence are
       <Ctrl> and <Right shift>.  To specify other ones, place one or
       more of the letters C, A, L, and R after the /T: switch.  Note
       that the <Right shift> and <Left shift> keys are different to
       IBM-compatible PCs.

            Although FRMDSK can send text to other programs rather
       quickly, many programs cannot process lines at FRMDSK's top
       speed.  As a result, a real-time way and the /D switch are
       provided to specify how long your program has to process each
       line.  (If you guess too short a time, press 'W' for "Wait" and
       pop-up FRMDSK again when your program is ready.  FRMDSK will
       resume where it left off.  If the time is too long, press 'D' for
       "change line-send Delay" and enter a smaller number.)  The unit
       is timer ticks, which are approximately 1/18 seconds.  The
       default value of 22 was chosen so that FRMDSK works with QMODEM.

            In order for FRMDSK to tell if it has already been loaded,
       it places a recognition code in memory.  If the default
       recognition code matches that of another vendor's TSR, you can
       change FRMDSK's code by using the /R switch.


       B.   Input-Screens' Options

       Since FDSMALL does no file-name handling, it only displays the
       Send This Line and Edit Line screens.  For FRMDSK, the opening
       screen or window has two or three options, depending on whether
       it is safe to remove FRMDSK from memory:

       <Esc>               Clears the file name line.

       <F10>               Closes the window and returns the computer to
                           your BBS or other application program.

       <PgDn>              Removes or unloads FRMDSK from memory.

            The file-name pick-list screen appears if you enter a name
       containing either of the DOS wild-card characters '?' or '*'.
       Its title is the directory containing the set of files specified
       by the file name.  Choose a file by pressing the up or down arrow
       keys to highlight one and then press <Enter> to select it.  This
       window also responds to <Home>, <End>, <PgUp>, <PgDn> and <Esc>.
       If you press <Esc>, you will be presented with the File Not Found
       window.

            The File Not Found window lets you correct the file name or
       pattern.  Its options are as follows:

       <Esc>               Clears the file name line.




                                    Page 5




       <PgUp>              Restores the file name to what it was on the
                           opening screen.

       <F10>               Closes the window and returns the computer to
                           your BBS or other application program.

            The Send This Line window presents the current file line and
       provides many options.  In addition, it displays the file name
       and current line's position and size.  The size is useful since
       at certain times, such as entering a file description, you are
       limited to a fixed number of characters.  Its options, which are
       chosen by pressing the highlighted and capitalized key, are as
       follows:

       Yes                 Sends the line to the keyboard so it can be
                           read by your program.

       <Enter>             Same as "Yes".

       Finish file         Same as "Yes" for the current line and the
                           rest of the file.  To stop sending lines,
                           press <Scroll Lock> to turn on its light.  To
                           reactivate this option, turn off the Scroll
                           Lock light.

       Edit                Presents you with the Edit Line screen so
                           that you can edit the current line.

       Wait                Closes the window and allows you to resume
                           with the current line when you pop up FRMDSK
                           again.

       Cancel              Closes the window and the file.

       Next line           Presents the next line in the file.

       Previous line       Returns FRMDSK to the previous line in the
                           file.  You may use this option repeatedly
                           until you reach the first line of the file.

       <Home>              Returns FRMDSK to the first line in the file.

       Another file        Allows you to select another file (or unload
                           FRMDSK) from the opening screen.  For
                           FDSMALL, this choice is equivalent to <Home>.

       change line-        Allows you to change how long FRMDSK gives
       send Delay (in      your program to process a line.
       1/18 seconds):





                                    Page 6




            Finally, the Edit Line screen provides the following
       options:

       <Esc>               Clears the current line.

       <PgUp>              Restores the current line.


       C.   Troubleshooting

       File read errors:
       Try a disk repair utility to fix your disk.  There are now such
       utilities in recent versions of DOS.  For serious problems, you
       may wish to consider a third party product.

       Your program stops while reading keys:
       Press a shift key or the right arrow key (and ignore the beep).

       Your program does not finish processing each line:
       Increase the number of timer ticks (1/18 seconds) for FRMDSK to
       wait either by using the /D switch or by pressing 'D' from the
       Send This Line screen.

       FRMDSK waits too long after sending a line:
       Decrease the number of timer ticks (1/18 seconds) for FRMDSK to
       wait either by using the /D switch or by pressing 'D' from the
       Send This Line screen.


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


       D.1.  System Tools (DOS)

       WRDGRB 1.2 -- Copies Words From DOS Screen to Command Line:

       No more typing words you see on the DOS screen!  With WRDGRB
       installed, you simply press the selectable hot-key sequence,
       highlight text with your mouse, and left click to copy it to the
       command line (or right click to cancel).  New: double clicking on
       a directory-listing basename highlights and connects entire
       filename, can run off a CD-ROM, and more.  Free upgrade for
       implemented suggestions or bug fixes; details in WRDGRB.TXT.  23K
       TSR.  No known bugs.  GO SWREG (#5571) to register on-line.
       Shareware by FileJockey Software (GO PCUTIL, Library 3, $30).



                                    Page 7




       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)


       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)


       D.2.  Programmer Tools (DOS, Windows)

       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))


       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)





                                    Page 8




       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)


       D.3.  BBS-Session Tool (DOS)

       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 and better word wrapping.  (GO PCCOM, Library 2, $5)


       E.   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 FRMDSK 1.1 ("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 $5 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



                                    Page 9




       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 10

