
    DBF2HTML
    DBF to HTML Converter

    Version 1.01

    Copyright (c) 1997,1999 by Simone Govoni
    e-mail: simgov@tin.it

    All trademarks are recognised as belonging to their respective owners.


    1.  INTRODUCTION

    DBF2HTML reads a DBF file and makes an HTML file which contains a table
    with all the records included in the DBF. The HTML file produced is ready
    to be distributed on the Web.

    2.  SYSTEM REQUIREMENTS

    DBF2HTML can be executed on every computer equipped with DOS 3.0 or
    higher. You should have no problems running it on an old PC powered by an
    8088 CPU and with 256KB of RAM.

    3.  INSTALLATION

    To install DBF2HTML on your computer simply copy the file DBF2HTML.EXE on
    a directory on your path.

    4.  USAGE

    DBF2HTML is very easy to use. The command line is:

        DBF2HTML [switches] dbffile[.dbf] [htmlfile[.htm]]

    where square brackets highlite an optional argument. dbffile is the name
    of the DBF file to read (.dbf is the default extension), while htmlfile is
    the name of the file to create (.htm is the default extension). If
    htmlfile.HTM already exists it WILL BE OVERWRITTEN WITHOUT CONFIRM. If the
    user doesn't specify a name for the htmlfile then DBF2HTML will send its
    output to dbffile.HTM where dbffile is the base name of the input file.

    Entering DBF2HTML /h at the DOS prompt gives you a summary of recognized
    switches.

    Here follows a more detailed explanation:

    /b  Set the table border width to a specified value. If the /b switch
        isn't specified then the table has no border.

        Examples:

        dbf2html cars.dbf               The HTML table has no border.

        dbf2html /b3 cars.dbf           Set the table border width to 3.

    /c  Set the table caption. The caption will appear above the table unless
        the /B switch is used. Inside the caption the following macros can
        be used:

        $f      the name of the input DBF file;

        $q      the '"' character;

        $p      the '%' character.

        $$      the '$' character;

        Example:

        dbf2html /c"Association members" members.dbf

        dbf2html /c"Database: $f" cars.dbf

    /B  If used with the /c switch the caption will appear below the table.
        This switch has no effect if used without the /c switch.

        Example:

        dbf2html /c"Association members" /B members.dbf

    /d  Records marked as deleted are excluded from the HTML table.

    /f  With this switch you can specify which fields should appear in the
        output (default: all). The /f switch must be followed by a comma
        delimited list of field numbers: only these fields will be inserted in
        the HTML table. The space between /f and the list is not mandatory.

        Examples:

        dbf2html /f1,3 cars.dbf         Only the first and the third field
                                        will be included in the HTML table.

        dbf2html /f cars.dbf            Error: missing field list.

        dbf2html cars.dbf               All fields will be included in the
                                        HTML table.

        Wrong field numbers (too high, too low, not numeric) are ignored and
        don't stop the execution. The /s option can be used to get the field
        numbers.

    /l  Display dates using the four digits format for the year indication.
        Without this switch, date fields are displayed reserving two digits to
        the year.

    /s  Display the structure (the field list) of the DBF file.

    /t  Set the HTML document title. The title usually doesn't appear in the
        document. The same macros as those that appear in the caption ($f, $q,
        $p, $$) may be used inside the title. See the explanation of the /c
        switch for further details.

    DBF2HTML is case sensitive about the switch list; /B is different from /b.
    Date type fields are printed using the local format as set by the COUNTRY
    entry in the CONFIG.SYS file (default is US format) and using the correct
    separators.

    5.  LIMITATIONS AND BUGS

    I've tested DBF2HTML only with DBF files produced by Clipper 5.2 and dBASE
    III+. The HTML tables produced by DBF2HTML have been tested with Netscape
    Navigator 2.02 for Win31 and Microsoft Internet Explorer 3 for Win95.

    DBF2HTML can't process memo fields. The only recognized field types are:
    character, numeric, logical and date.

    DBF2HTML doesn't process index files (those with extension NDX and NTX).

    6.  FEEDBACK & SUPPORT

    If you have suggestions, bugs notifications or any other kind of
    complaint, please drop me an e-mail. If you like the program feel free to
    let me know about by sending me an e-mail.

    7.  LICENSE

    DBF2HTML v1.01 is freeware. It is covered by the GNU General Public 
    License. See the file COPYING for details.

    THE SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY
    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
    AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL THE AUTHOR BE
    LIABLE FOR DIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF THE
    AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

    8.  REVISION HISTORY

    1.01 Fixed docs and included source code. Now under GPL.    

    1.00 First released version.

    9.  OTHER PRODUCTS

    Simone Govoni is also the author of dBTAB: dBTAB builds a TAB-delimited
    ASCII report from a DBF database file. The report can be easily imported
    into Word or Wordperfect (and printed with a proportional font) by
    converting it into a table. Output can be customized using a user-supplied
    mask.
