CARDREAD Version 1.4

        SYNTAX:

        CARDREAD file.crd -w## -r"##" -f"##" -l## -? -p"##" -oFILE -s##

        Description:
                CARDREAD enables one to view the contents of a CARDFILE
        file generated under Windows 3.1 from within DOS.  The CARDFILE
        must contain only "text" cards.  The following command line
        options are available

        -w##    Set the number of characters before line wrapping to ##.
                The default value is 40, which corresponds to the width
                of the Windows card.

        -r"##"  Set the string to delimit records (cards) to ##.  The
                default value is "\n\n---------------------------\n"

        -f"##"  Set the string to delimit fields (or lines) to ##.  The
                default value is "\n"

        -l##    Set the maximum number of lines per page for printing
                records (cards) to ## lines.  This number should not
                include margins.  If set <= 0, page breaks are not printed.

        -p"##"  Sets the string which is printed after a formfeed when
                a page break is needed. The default value is "\n\n"

        -?      Prints a summary of the command options

        -oFILE  Prints the output to the specified file.  If this command
                is not specified, output is printed to the screen.  Note
                that a printer device can be specified (lpt1 for example)
                if it is desired to print the result of the program.

        -s##    Prints only those cards which have an index entry that
                begin with the specified string.  If the specified string 
                begins with an '*' then prints those cards which have an
                index entry that includes the specified string.


        Notes:

        CARDREAD has several possible uses:

        1.  Print the contents of a cardfile using considerably less paper
        than by using the "Print All" command from within CARDFILE.  
        CARDREAD tries to ensure that page breaks do not occur in the middle
        of a record.  This can be disabled by specifying the maximum lines
        to be 0.

        Example:  cardread file.crd -olpt1

        2.  Print each card on a seperate page.  This is accomplished by
        specifying the maximum lines per page to be 1.

        Example:  cardread file.crd -l1 -olpt1

        3.  Import the contents of a cardfile into a word processing program
        by writing the output to a file which can then be imported into the
        word processing program:

        Example:  cardread file.crd -l0 -ofile.txt -r"\n\n\n"

        4.  Import the contents of a cardfile into a spreadsheet.  This is
        done by writing each card on a single line, with fields seperated
        by character delimiters.  Once the output file is imported into the
        spreadsheet, the data is parsed using the appropriate spreadsheet
        command:

        Example:  cardread file.crd -l0 -ofile.txt -r"\n" -f"^"

        5.  Use the search function to list the data of a specific card.
        For example, include the following in a batch file:

        Example (file.bat): 
          @echo off
          cardread file.crd -s"*%1" | more
          echo .
          pause

        file roger
        will list those cards with the string 'roger' anywhere in the index. 

        Special Notes:

        1.  The "strings" used to represent the various delimiters 
        should use standard C syntax for specifying special characters.
        "\n" for example, is the "new line" character.  Hex codes
        can be specified by entering "\x##".  Octal codes by "\###".