










                           CSS  DESKTOP     UTILITIES

                            SHAREWARE EVALUATION VERSION

                                  REFERENCE MANUAL
                                     Version 1.0






                                Common Sense Software
                                   P.O. Box 50941
                             Indianapolis, Indiana 46250
                                   (317) 594-0820



          This manual and the CSS Desktop Utilities are Copyright (C) 1992
                   by Common Sense Software.  All rights reserved.

           Family Tree Print Utility, GENCHECK, and Common Sense Software
                      are trademarks of Common Sense Software.



                                                          GENCHECK - Page 2


                                  TABLE OF CONTENTS

          COPYRIGHT...................................................2
          LIMITATION OF LIABILITY.....................................2
          SHAREWARE REGISTRATION INFORMATION..........................3
          TRADEMARK ACKNOWLEDGMENT....................................4
          SUPPORT.....................................................4
          REQUIRED EQUIPMENT..........................................5
          INTRODUCTION................................................5
          INSTALLATION................................................5
          BIFF.EXE - BINARY FILE DIFFERENCE UTILITY...................5
          DIFF.EXE - ASCII FILE DIFFERENCE UTILITY....................7
          FASTFORM.EXE - FAST DISK FORMATTER UTILITY..................10
          GREN.EXE - GENERIC RENAME UTILITY...........................11
          OPERATION - SEARCH.EXE......................................12
          A LOOK AHEAD................................................14
          REGISTRATION FORM - CSS DESKTOP UTILITIES VERSION 1.0.......16

                                      COPYRIGHT

          The CSS Desktop Utilities and manual are Copyright 1992 by Common
          Sense Software.  Portions Copyright 1982-1990 Microsoft Corp.

                               LIMITATION OF LIABILITY

          THE CSS DESKTOP UTILITIES SOFTWARE ARE SUPPLIED AS IS.  COMMON
          SENSE SOFTWARE MAKES NO WARRANTY OR REPRESENTATION, EITHER
          EXPRESSED OR IMPLIED, WITH RESPECT TO THESE PROGRAMS, REFERENCE
          MANUAL OR DOCUMENTATION INCLUDING THEIR QUALITY, PERFORMANCE,
          MERCHANT ABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

          IN NO EVENT WILL COMMON SENSE SOFTWARE BE LIABLE FOR DIRECT,
          INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
          OUT OF THE USE OR INABILITY TO USE THESE PROGRAMS, REFERENCE
          MANUAL OR DOCUMENTATION, EVEN IF COMMON SENSE SOFTWARE IS ADVISED
          OF THE POSSIBILITY OF SUCH DAMAGES.  IN PARTICULAR, COMMON SENSE
          SOFTWARE IS NOT RESPONSIBLE FOR ANY COSTS INCLUDING BUT NOT
          LIMITED TO THOSE INCURRED AS A RESULT OF LOST PROFITS OR REVENUE,
          LOSS OF USE OF COMPUTER PROGRAMS, LOSS OF DATA, THE COST OF
          SUBSTITUTE PROGRAMS, CLAIMS BY THIRD PARTIES OR FOR OTHER SIMILAR
          COSTS.  IN NO EVENT SHALL COMMON SENSE SOFTWARE'S LIABILITY FOR
          ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE SOFTWARE LICENSE,
          REGARDLESS OF THE FORM OF CLAIM.  THE PERSON USING THE SOFTWARE
          BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.

          Some states do not allow the exclusion of the limit of liability
          for consequential or incidental damages, so the above limitation
          may not apply to you.

          This agreement shall be governed by the laws of the State of
          Indiana and shall inure to the benefit of Common Sense Software
          and any successors, administrators, heirs and assigns.  Any
          action or proceeding brought by either party against the other
          arising out of or related to this agreement shall be brought only



                                                          GENCHECK - Page 3


          in a STATE or FEDERAL COURT of competent jurisdiction located in
          HAMILTON county, INDIANA.  The parties hereby consent to in
          personam jurisdiction of said courts.

          Common Sense Software reserves the right to update the contents
          of the CSS Desktop Utilities and their associated documentation
          at its discretion and without the consent of or any obligation to
          any licensed users.

                         SHAREWARE REGISTRATION INFORMATION

          Shareware distribution gives users a chance to try software
          before buying it.  If you try a Shareware program and continue
          using it, you are expected to register.  Individual programs
          differ on details - some request registration while others
          require it, some specify a maximum trial period.  With
          registration, you get anything from the simple right to continue
          using the software to an updated program with printed manual.

          Copyright laws apply to both Shareware and commercial software,
          and the copyright holder retains all rights, with a few specific
          exceptions as stated below.  Shareware authors are accomplished
          programmers, like commercial authors, and programs are of
          comparable quality.  (In both cases, there are good programs and
          bad ones!) The main difference is in the method of distribution.
          The author specifically grants the right to copy and distribute
          the software, either to all and sundry or to a specific group.
          For example, some authors require written permission before a
          commercial disk vendor may copy their Shareware.

          Shareware is a distribution method, not a type of software.  You
          should find software that suits your needs and pocketbook,
          whether it's commercial or Shareware.  The Shareware system makes
          fitting your needs easier, because you can try before you buy.
          And because the overhead is low, prices are low also.  Shareware
          has the ultimate money-back guarantee - if you don't use the
          product, you don't pay for it.

          The CSS Desktop Utilities are Shareware programs and are provided
          at no charge to the user for evaluation.  The essence of "user-
          supported" software is to provide personal computer users with
          quality software without high prices, and yet to provide
          incentive for programmers to continue to develop new products.
          If you find these programs useful and are continuing to use them
          after a reasonable trial period, you must make a registration
          payment of $10 to Common Sense Software.  The CSS Desktop
          Utilities took many man-hours of software development effort to
          produce, and registration fees are the ONLY WAY the authors
          receive compensation for their time and effort.  Help to keep the
          Shareware concept alive and well by becoming a registered user
          after your evaluation period.  The CSS Desktop Utilities are not
          copy protected or "crippled" in any way from the registered
          user's version; Common Sense Software is counting on each user's



                                                          GENCHECK - Page 4


          honesty to register their copy.  EVERY REGISTRATION COUNTS,
          INCLUDING YOURS!

          The cost of registration is $10.  As a registered user, you will
          receive the latest registered user's version of the programs and
          a registration number which will allow us to inform you of future
          enhancements, and provide you with upgrades and new products at
          reduced prices.  Registered users also receive technical support
          by both mail and phone.  A registration form is provided at the
          end of this documentation for your convenience.

          Common Sense Software is a member of the Association of Shareware
          Professionals (ASP).  ASP wants to make sure that the shareware
          principle works for you.  If you are unable to resolve a
          shareware-related problem with an ASP member by contacting the
          member directly, ASP may be able to help.  The ASP Ombudsman can
          help you resolve a dispute or problem with an ASP member, but
          does not provide technical support for members' products.  Please
          write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
          or send a CompuServe message via CompuServe Mail to ASP Ombudsman
          70007,3536.

                              TRADEMARK ACKNOWLEDGMENT

          Common Sense Software is a trademark of Common Sense Software.
          Microsoft and MS-DOS are registered trademarks of Microsoft
          Corporation.  IBM, XT, AT and PC-DOS are registered trademarks of
          International Business Machines Corporation.

                                       SUPPORT

          Support will be provided to REGISTERED USERS by mail, CompuServe,
          Prodigy, and telephone.  Telephone support will be available
          weekday evenings from 6PM to 9PM Eastern Standard Time (EST) and
          weekends from 10AM to 5PM EST.

                    CompuServe: E-Mail to: Keith R. Wehmeyer (70274,3020)

                    Prodigy:    E-Mail to Keith R. Wehmeyer (VMSR09A)

                    Address:    Common Sense Software
                                P.O. Box 50941
                                Indianapolis, Indiana  46250

                    Phone:      (317) 594-0820

          Please note that we are unable to assist you with directions
          concerning the use of other programs with the CSS Desktop
          Utilities.


                                 REQUIRED EQUIPMENT



                                                          GENCHECK - Page 5


          The CSS Desktop Utilities will run on most IBM or compatible
          computers with 256K of RAM, PC-DOS or MS-DOS 2.1 or greater and
          two disk drives.

                                    INTRODUCTION

          The CSS Desktop Utilities were created to assist in the every-day
          operation of the typical computer user.  The utilities consist of
          five programs with the following capabilities:

          1.BIFF.EXE - A Binary file "Difference" program, which compares
            two binary files and looks for differences.  This can be used
            to compare two separate data files in order to note any
            changes or differences.
          2.DIFF.EXE - An ASCII file "Difference" program, which compares
            two human-readable text files to find changes or differences.
          3.FASTFORM.EXE - A fast formatting program which can be run from
            a .BAT file, and formats 360K, 720K, 1.2M, and 1.44M diskettes
            (both 5.25" and 3.5") with a variety of options.  Formatting
            can be accomplished in as little as 28 seconds for a 360K
            diskette, compared to 40 seconds for DOS's FORMAT.
          4.GREN.EXE - A Generic Rename program, which can rename files
            and sub directories, and automatically move renamed files to
            new sub directories.
          5.SEARCH.EXE - A file Search program, which scans one or
            multiple files for a given phrase or word.

          This manual is divided into the following sections.  The first
          part provides installation and set-up information so you can get
          the CSS Desktop Utilities running on your computer.  A brief
          description of how to operate each utility program then follows.

          While the CSS Desktop Utilities were designed to be operated by
          the computer novice with little training, please take the time to
          read this manual and get to know their capabilities.  It is best
          to run each utility program as you read along, so that you can
          understand exactly how it works.

          Enjoy the programs!  We hope the CSS Desktop Utilities are a
          valuable assistant in you everyday computer operation.

                                    INSTALLATION

          Installation of the CSS Desktop Utility programs is easy, even
          for the novice computer user.  Simply insert the Master diskette
          into your diskette drive (A: or B:) then run the installation
          program by typing "A:INSTALL" or "B:INSTALL" and pressing the
          ENTER key.  Follow the directions which follow to install the
          programs on either a floppy diskette or your hard drive.

                      BIFF.EXE - BINARY FILE DIFFERENCE UTILITY

          BIFF.EXE is the binary version of DIFF; it does differences on
          any file type, byte by byte, in binary mode, displaying the



                                                          GENCHECK - Page 6


          differences in hexadecimal (Base 16) notation.  While similar to
          the DIFF utility, it differs in a number of significant ways.  In
          normal mode, BIFF will list the difference regions sequentially,
          separated by a double bar, with the first file's contents on top.
          Each line of output is preceded by the starting byte number.
          Bytes are numbered in the file starting at 1.  Each byte in the
          difference region will be shown in hexadecimal notation on the
          left, and ASCII notation on the right, separated by a vertical
          bar.  If a byte cannot be represented in ASCII on the screen
          and/or printer, it will be shown as an asterisk ('*').  In
          parallel mode, each difference region will contain all of the
          bytes in the difference section, but no ASCII representation.
          Both modes provide a closing summary, consisting of the number of
          difference sections found, and the number of total bytes in those
          sections.

          When invoking BIFF, you mush supply the name of at least two
          files for BIFF to operate on.  If they are not supplied, or are
          specified incorrectly, BIFF will prompt you for them.  Other
          command line parameters you may wish to supply, but for which you
          will not be prompted, include the following:

          PARALLEL - or any abbreviation thereof, in upper, mixed or lower
          case. If selected, the differences between the files will be
          presented to you in the parallel format discussed above, with a
          file name header, and concurrent difference regions headed by the
          starting file byte number.

          OUTPUT FILE - If a third file name is specified on the command
          line, BIFF will write it's output to this file and not the
          screen.  If the file already exists, it is over-written without
          any warning.

          MATCH - the number of bytes that must match after a section of
          differing data before BIFF decides that the files are
          resynchronized.  The default is 30 bytes.  MATCH can be between 1
          and 79.

          WIDTH - the number of characters per line BIFF will display. In
          the parallel mode, the number of displayed bytes from each file
          is roughly equal to (WIDTH / 6 - 1), while in normal mode it is
          (WIDTH / 4 - 3).  The default value is 80 characters, with valid
          values extending upward to 255 characters.

          BIFF will apply the integers you supply in the command line to
          the proper parameters according to their value.  Input files must
          be specified first and the output file specified last, and any
          other parameters which are not numbers or 'parallel' will be
          ignored.  MATCH and WIDTH parameters may be specified multiple
          times, the last values read being the ones BIFF will use.  File
          name and integer parameters may be intermixed.  An example:

          C> biff first.dat 40 second.dat 132 file.dif



                                                          GENCHECK - Page 7


          This command entry would cause BIFF to calculate the differences
          between FIRST.DAT and SECOND.DAT using a match value of 40 bytes,
          and place the 132 column wide output in the file FILE.DIF.
          Another example:

          C> biff 140 file.xxx file.yyy lpt1 2 para

          This command entry would cause BIFF to print the differences
          between FILE.XXX and FILE.YYY with 140 character wide output
          being sent to the printer attached to the first parallel port of
          the machine.  The differences would be calculated with a match
          value of 2 bytes and displayed in the parallel format.

          BIFF produces output that contains characters only printable by
          an IBM ProPrinter or compatible device.  IBM ProPrinter XLs can
          be fed with 8-, 11-, or 14-inch paper, and print in pica (10
          CPI), elite (12 CPI), or condensed (17.1 CPI) print modes.
          Consult your ProPrinter User's Manual for instructions on loading
          different sizes of paper and invoking the different print modes.
          Use the chart below to determine the number of characters per
          line for each setup:

                                Paper width
                               8"   11"   14"
                            +-----+-----+-----+
                         10 :  80 : 110 : 140 :
                    C       +-----+-----+-----+
                    P    12 :  96 : 132 : 168 :
                    I       +-----+-----+-----+
                         17 : 137 : 188 : 239 :
                            +-----+-----+-----+

          While BIFF should work on just about any file you may have, it
          does have some limitations:

          Maximum number of:
            bytes per file               - 4,294,967,295 (4 MBytes - 1)
            bytes per difference section -        65,534
            difference sections          -        65,535

          BIFF gives no warning when these limits are reached, and may halt
          DOS or other programs in memory if they are exceeded.

                      DIFF.EXE - ASCII FILE DIFFERENCE UTILITY

          DIFF.EXE is the equivalent of the VMS DIFF command, found on the
          VAX line of computers by Digital Equipment Corporation.  However,
          there are several differences.  Unlike the VMS command, DIFF will
          not work predictably on binary files, nor will it recognize
          differences in lines beyond the 255th character.  Many of the VAX
          qualifiers are not supported in this version, but sufficient
          interest in these features could prompt their integration.



                                                          GENCHECK - Page 8


          When invoking DIFF, you mush supply the name of at least two
          files for DIFF to operate on.  Wild cards are supported in the
          first file name only.  If wild cards are used, the second file
          name must be a valid DOS path name.  If they are not supplied, or
          are specified incorrectly, DIFF will prompt you for them.

          If a wild card name is specified, DIFF will search for files that
          match the wild card spec. in the directory specified with that
          name, or the default directory if none is specified.  It will
          then search for each found file by name in the path specified in
          the second file name.  If no match is found for that file, a
          message is printed to that effect, and processing continues.

          Other command line parameters you may wish to supply, but for
          which you will not be prompted, include the following:

          PARALLEL - or any abbreviation thereof, in upper, mixed or lower
          case.  If selected, the differences between the files will be
          presented to you in the  VMS /PARALLEL format with a file name
          header, and concurrent difference regions headed by the starting
          line number.  If not selected, the difference regions will be
          listed sequentially, separated by a double bar, with the first
          file's contents on top.  Both modes provide a closing summary.

          TABS - or any abbreviation thereof, in upper, mixed or lower
          case.  If selected, this qualifier instructs DIFF to treat any
          tabs found in each file as the appropriate number of blanks
          during the compare operation.  Without this qualifier, DIFF will
          identify lines as different when a tab has replaced one or more
          blanks in the original (or vice-versa), even though the lines in
          the output appear to be identical.  With this qualifier, DIFF
          will evaluate the lines based on their perceived spacing.

          OUTPUT FILE - If a third file name is specified on the command
          line, DIFF will write it's output to this file and not the
          screen.  If the file already exists, it is over-written without
          any warning.

          MATCH - the number of lines that must match after a section of
          differing text before DIFF decides that the files are
          resynchronized.  The default is 3 lines, the same as the VAX.
          MATCH can be between 1 and 79 lines.

          WIDTH - the number of characters per line DIFF will display.  In
          the parallel mode, the number of displayed characters from each
          file is roughly equal to (WIDTH / 2 - 2).  The default value is
          80 characters, with valid values extending upward to 255.

          GRAPHICAL - By default, DIFF uses ASCII characters to draw the
          separator bars (or in parallel mode, boxes) in the output
          listing.  If you would like DIFF to  use the extended ASCII set
          line drawing characters to make these, specify GRAPHICAL, or any
          abbreviation thereof, in upper, mixed or lower case.  These line
          drawing characters make for better-looking output, but take a



                                                          GENCHECK - Page 9


          long time to print on a ProPrinter printer, and some printers
          (e.g. Epson) won't handle them at all.  In general, you should
          only use GRAPHICAL output for presentation purposes.

          DIFF will apply the integers you supply in the command line to
          the proper parameters according to their value.  Input files must
          be specified first and the output file specified last, and any
          other parameters which are not numbers or 'parallel' or 'tabs'
          will be ignored.  MATCH and WIDTH parameters may be specified
          multiple times, the last values read being the ones DIFF will
          use.  File name and integer parameters may be intermixed.  An
          example:

          C> diff first.dat 4 second.dat 132 file.dif

          This command entry would cause DIFF to calculate the differences
          between FIRST.DAT and SECOND.DAT using a match value of 4 lines,
          and place the 132 column wide output in the file FILE.DIF.
          Another example:

          C> diff 140 *.c source\ lpt1 2 para gra

          This command entry would cause DIFF to print the differences
          between all the files matching the wild card specification *.C
          and those files matching the same wild card name in the sub
          directory SOURCE\.  The output will be 140 columns wide, and sent
          to the printer attached to the first parallel port of the
          machine.  The differences would be calculated with a match value
          of 2 lines and displayed in the parallel format. The printer
          attached must be able to handle the IBM extended character set
          line drawing characters, as GRAPHICAL output boxes have been
          specified.

          In GRAPHICAL mode, DIFF produces output that contains characters
          only printable by an IBM ProPrinter or compatible device.  IBM
          ProPrinter XLs can be fed with either 8-, 11-, or 14-inch paper,
          and print in either pica (10 CPI), elite (12 CPI), or condensed
          (17 CPI) print modes.  Consult your ProPrinter manual for
          instructions on loading different sizes of paper and invoking the
          different print modes.  Use the chart below to determine the
          number of characters per line for each setup:

                                Paper width
                               8"   11"   14"
                            +-----+-----+-----+
                         10 :  80 : 110 : 140 :
                    C       +-----+-----+-----+
                    P    12 :  96 : 132 : 168 :
                    I       +-----+-----+-----+
                         17 : 137 : 188 : 239 :
                            +-----+-----+-----+

          Only files written with CR or CR-LF record separators will work
          correctly with DIFF.  EDLIN, QuickC, Programmer's Workbench and



                                                         GENCHECK - Page 10


          EDT+ all produce files of this type.  Files downloaded to the PC
          with KERMIT or XMODEM are usually written in this manner. Files
          created with Word, Write and Displaywrite must be exported to
          ASCII before DIFF can be used effectively on them.

          Maximum number of:
            files per run       -  unlimited
            lines per file      -      32767
            chars per line      -        256
            difference sections -      32767
            difference lines    -      32767

                     FASTFORM.EXE - FAST DISK FORMATTER UTILITY

          FASTFORM is a general purpose, high speed disk formatting program
          which supports IBM PCs, XTs, and ATs and compatibles, as well as
          both 5.25" and 3.5" diskette drives.  FASTFORM uses your
          computer's BIOS (Basic Input / Output System) to control your
          floppy drive, permitting it to work with nearly all types of disk
          drive and controller card combinations.

          All FASTFORM parameters must be supplied on the command line
          using the following syntax.  Parameters not meeting the syntax
          will be ignored.

          C> fastform [DRIVE] [DENSITY] [/V] [/nnn]

          The parameter DRIVE specifies which drive is to be formatted.
          The permissible values are A: or B:, as FASTFORM does not support
          hard disk formatting.  If DRIVE is not specified, FASTFORM
          assumes the A: drive.

          The DENSITY parameter specifies if the density of the format.
          The permissible values are LOW or HIGH, which may be entered in
          any combination of upper and lower case letters.  For a 5.25"
          diskette drive, use LOW to format a 360K floppy, and HIGH to
          format a 1.2M floppy.  For a 3.5" diskette drive, use LOW to
          format a 720K floppy, and HIGH to format a 1.44M floppy.  If
          DENSITY is not specified, FASTFORM determines the type of drive
          in the computer and attempts to format the diskette for the
          highest density possible in that drive.

          Diskettes may be optionally verified while they are being
          formatted by adding the /V qualifier in either upper or lower
          case.  Diskettes which are verified take longer to format, but
          are guaranteed to have correct formatting information on each
          track.  By default, no verification is performed, so that
          diskettes may be formatted as quickly as possible

          The final FASTFORM parameter is used to specify the number of
          sectors which will be allocated to diskette directory area.  Each
          sector holds information on up to 16 files.  Both 360K and 720K
          diskettes by default allocate 7 sectors, for a total of 42 files
          permissible on a single diskette.  High density diskettes, such



                                                         GENCHECK - Page 11


          as 1.2M and 1.44M, allocate 14 sectors, for a total of 84 files
          per diskette.  You may choose to reduce the number of sectors
          allocated for directory space in order to maximize free space
          (for BACKUP purposes, for example), or you may expand the amount
          of directory space allocated in you want to put many small files
          on a single diskette.  Maximum allocation values are as follows:

                          360K diskette  23 sectors
                          720K diskette  85 sectors
                          1.2M diskette 141 sectors
                         1.44M diskette 169 sectors

          If no parameter is specified, FASTFORM uses the default values
          normally used by DOS for the formatting process.  An example:

          C> fastform

          FASTFORM will format a diskette in the A: drive at the highest
          possible density for that drive, with no verification, and with
          the default number of sectors allocated for directory storage.

          C> fastform b: low /v /10

          FASTFORM will format a diskette in the B: drive at LOW density
          (360K or 720K, depending upon the drive type) and verify while
          formatting.  FASTFORM will then allocate 10 sectors for directory
          space, permitting 160 files to be stored on this diskette.

          Another significant advantage of FASTFORM over the DOS FORMAT
          command is its ability to be run from a Batch file.  FASTFORM
          will wait to begin formatting until a diskette is inserted and
          ready to format.  This includes testing to make sure that the
          diskette is not write-protected.  If any problems occur during
          the formatting process, an error message is displayed and a non-
          zero number is returned to the Batch file using the DOS
          ERRORLEVEL parameter.  See your DOS manual for additional
          information on ERRORLEVEL and how you can use it in your DOS
          Batch file application.

                          GREN.EXE - GENERIC RENAME UTILITY

          GREN is a general rename utility for the PC. Not only can it
          rename files, but sub-directories as well, and can move files
          from one sub directory to another.  Sub-directories cannot be
          moved.

          GREN must be called with two arguments. The first is the current
          name of the object, and the second is the new name. Only the
          first two arguments are acted upon.

          Examples:

            C> GREN fred.dat george.dat



                                                         GENCHECK - Page 12


          This example will rename the file FRED.DAT in the current sub-
          directory to GEORGE.DAT.

            C> GREN \data\new \data\old

          This example renames the sub-directory NEW to OLD. Note that the
          directory is referenced from the top level directory. This allows
          the renaming of sub-directories not in the current tree.

            C> GREN old\data old\buddy

          This example renames the sub-directory OLD to BUDDY, but it is
          referenced from the current working directory.

            C> GREN \input\file.in \output\file.out

          This example renames the file FILE.IN to FILE.OUT, and moves it
          to the OUTPUT sub-directory.

          Error Messages:

          'Usage: GREN from to' - Insufficient number of parameters
          supplied.  Supply both the source and destination parameters.

          'No access permitted for xxxxxxxx.xxx' - The object was marked
          read-only, it was locked by another user, an error occurred
          during the rename or the disk was not present.

          'xxxxxxxx.xxx does not exist.' - The specified object could not
          be found.

          'Cannot rename to a different device.' - An attempt was made to
          move a file to a different logical disk.


                               OPERATION - SEARCH.EXE

          SEARCH.EXE is the equivalent of the VMS SEARCH command found on
          the VAX.  However, there are some differences.  Unlike the VMS
          command, SEARCH will not work predictably on binary files, nor on
          files with lines longer than 255 characters.  Also, you must have
          ANSI.SYS loaded as a device from the CONFIG.DAT file at boot
          time.  Many of the VAX qualifiers are not supported in this
          version, but sufficient interest in these features could prompt
          their integration.

          When invoking SEARCH, you must supply the name of the file for
          SEARCH to operate on and the string to search for, in that order.
          If they are not supplied, or are specified incorrectly, SEARCH
          will prompt you for them.  Wild cards as used in DOS are
          supported.  If you specify a wild card file name, all files
          matching that wild card spec. in the current default directory
          are searched.  If a file does not contain the string you are
          searching for, its name is not displayed.



                                                         GENCHECK - Page 13



          Search strings may be supplied with or without double quotes.  If
          you specify a search string which contains blanks or special
          characters, you MUST enclose it in double quotes.  If you wish to
          specify a search string which contains a quote, either single or
          double, do not supply it on the command line.  Search strings
          entered at the prompt are read literally, without the need of
          enclosing quotes, and single and double quotes may be specified
          there.

          Other command line parameters you may wish to supply, but for
          which you will not be prompted, include the following:

          OUTPUT= - To direct the output of the search function to a file
          or device, precede its name with the characters OUTPUT= in upper,
          mixed or lower case.  Do not include any blanks.  SEARCH will
          write it's output to this file and not the screen.  If the file
          already exists, it is over-written without any warning.  SEARCH
          highlights each occurrence of your search string when the output
          is going to the screen by using ANSI.SYS escape code sequences.
          Since these sequences would garble the output if it were going to
          a file and lock up (!) most printers, this is not done if the
          output is redirected.

          WORD - or any abbreviation thereof, in upper, mixed or lower
          case.  If selected, SEARCH will only display those occurrences of
          the search string which are not immediately preceded or followed
          by other letters, i.e. those strings which are entire words.

          NOEXACT - or any abbreviation thereof, in upper, mixed or lower
          case.  If chosen, SEARCH will ignore the case of all letters in
          matching the search string.

          BEFORE - the number of lines that SEARCH is to display that
          precede the located search string.  If this number of lines is
          not available when SEARCH encounters the string, it will display
          what it has.

          AFTER - the number of lines that SEARCH is to display that follow
          the located search string.  If this number of lines is not
          available when SEARCH encounters the string, it will display what
          it has.

          SEARCH will apply the first integer you supply in the command
          line to the BEFORE parameter and the second (and all subsequent
          ones) to the AFTER qualifier.  If you wish to have extra lines
          displayed after the occurrence but not before, you must still
          specify a value of zero(0) for BEFORE.

          Input file name must appear first, but other parameters may be
          intermixed.

          An example:



                                                         GENCHECK - Page 14


          C> search *.c printf 3 output=lpt1 3 word

          This command entry would cause SEARCH to find and print all
          occurrences of the string 'printf' (but not 'sprintf' and
          'fprintf' because WORD was specified) in all the files which
          match the wild card name '*.c' in the current directory on the
          printer attached to the first parallel port of the machine.  Each
          occurrence would be preceded and followed by the 3 surrounding
          lines in the file.

          Another example:

          C> search *.h " _MAX_LINE " 0 4 output=match.max

          This command entry would cause SEARCH to find and print all
          occurrences of the string ' _MAX_LINE ' (note the leading and
          trailing blanks; ' _MAX_LINE_NUM' and 'OUT_MAX_LINE ' would NOT
          be found) to the output file MATCH.MAX.  Each occurrence would be
          listed with the four lines which follow it in the file.

          Only files written with CR or CR-LF record separators will work
          correctly with SEARCH.  EDLIN, QuickC, EDT+ and PC-EDT all
          produce files of this type.  Files downloaded to the PC with
          KERMIT or XMODEM are usually written in this manner.  Files
          created with MultiMate, DisplayWrite and ManuScript must be
          exported to ASCII before SEARCH can be used effectively on them.

          Maximum number of...
            files per search        -   unlimited
            lines per file          -       32767
            chars per line          -         255
            lines before occurrence -         255 (approx.)
            lines after occurrence  -   unlimited

                                    A LOOK AHEAD

          This version of the CSS Desktop Utilities would not have been
          possible without the assistance of many registered users who
          contributed their ideas for new this new product.  In order for
          us to serve you better, please contact us with your ideas about
          new features for our programs.  New feature suggestions are
          always welcome; registered users may forward them to:

            Common Sense Software
            P.O. Box 50941
            Indianapolis, Indiana  46250

          Most importantly, we wish to thank our registered users for
          continuing to support the Shareware concept by registering their
          software and encouraging others to evaluate and register.  As
          registrations are our only means of support for these programs,
          we are indebted to you for your honesty.



                                                         GENCHECK - Page 15


                REGISTRATION FORM - CSS DESKTOP UTILITIES VERSION 1.0

          Last Name _____________________________ First Name _____________

          Address ________________________________________________________

          City _______________________ State __________ Zip ______________

          Phone (______) ______ - ________

          Where did you hear about these programs? ________________________

          _________________________________________________________________

          Hardware Configuration:

          ____ PC or clone   ____ AT or clone   ____ 386/486   ____ PS/2

          ____ Monochrome    ____ CGA color     ____ EGA       ____ VGA

          ____ Floppy        ____ Hard Disk (if checked, size: ____ MB)

          ____ Mouse         ____ Modem   Printer type ___________________

          Floppy Disk Type:  ____ 5.25" ____ 3.5"

          VISA/MasterCard# __ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __

          Expiration Date: ___ / ___  Authorized Signature: _______________

          Mail this form with your check for $10 (payable to Common Sense
          Software) in U.S. DOLLARS ONLY, or VISA / MasterCard number to:

            CSS Desktop Utilities Registration
            Common Sense Software
            P.O. Box 50941
            Indianapolis, Indiana 46250

          THANK YOU!!
