
    DBF2HTML
    DBF to HTML Converter

    Version 1.00

    Copyright (c) 1997 by Simone Govoni
    e-mail: govoni@cs.unibo.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. My e-mail address will be valid
    until last months of 1998.

    7.  LICENSE

    DBF2HTML v1.00 is copyrighted freeware:

    - You may use it at home, at the office or in any government institution,
      without any restriction.

    - You may distribute it without any restriction provided that you don't
      ask money for it, with the exception of a small distribution fee.

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

    dBTAB is free and can be downloaded from any Simtel.Net mirror. Its
    pathname is: /pub/simtelnet/msdos/database/dbt111.zip (the revision number
    may change).

    Here follows a short (and incomplete) list of Simtel.Net mirror sites:

        ftp://ftp.simtel.net/pub/simtelnet        (the official one)
        ftp://sunsite.anu.edu.au/pub/pc/simtelnet
        ftp://ftp.funet.fi/mirrors/ftp.simtel.net/pub/simtelnet
        ftp://ftp.ibp.fr/pub/simtelnet
        ftp://ftp.uni-magdeburg.de/pub/mirrors/simtelnet
        ftp://ftp.flashnet.it/pub/simtelnet
        ftp://ftp.iij.ad.jp/pub/simtelnet
        ftp://ftp.nic.surfnet.nl/mirror/simtelnet
        ftp://ftp.sun.ac.za/pub/simtelnet
        ftp://ftp.sunet.se/pub/simtelnet
        ftp://sunsite.cnlab-switch.ch/mirror/simtelnet
        ftp://ftp.demon.co.uk/pub/simtelnet
