CARDREAD Version 1.4

COPYRIGHT (C) 1994-2002 Norbert H. Doerry
28 May 2002

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

                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.


        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

        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 .

        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 "\###".

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.