
                           PAS2HTML 2.0

                  Pascal Source to HTML Converter


          Copyrighs(c)1996,97 by COAS, All rights reserved.


          PAS2HTML was written by Pieter Polak (pp@coas.com)




PAS2HTML is a conversion program which translates Delphi Pascal source files
into HTML format with Borland Delphi compatible syntax highlighting. This
makes it very easy to publish source code on the Web in a clear way. If you
have every tried to create a HTML page containing highlighted source you know
how much work this can be.


The contents of the package
===========================

The distribution archive of Pas2HTML contains four different versions of the
program which all rely on the same conversion engine:

PAS2HTML.EXE  - This is the original DOS 16-bit command line tool which
                gives you the posibility to convert you Pascal source files
                into HTML. You also specify wildcards to do batch conversions.
P2HWIN.EXE    - This is the 16-bit Windows version of the program. This tool
                will operate like a simple wizard, which allows you to specify
                a file or group of files to be converted.
P2HCGI.EXE    - This is a 32-bit executable which generates output suitable to
                be used as a CGI application on you WEB server. You can include
                links to Pascal files from your HTML pages using links like
                this: <A HREF="/cgi-bin/p2hcgi.exe?e:\public\pas\test.pas">,
                assuming you have copied P2HCGI.EXE to the /cgi-bin directory
                on your WEB server.
                You can use this program on any WEB server running on
                Windows NT which supports CGI (e.g. from Netscape or Microsoft).
P2HISAPI.DLL  - This is a 32-bit DLL which provides the same functionality
                as the CGI version, but this one is an ISAPI version. You
                can use it on a WEB server running Microsoft's IIS to
                achieve a much better performance than with CGI. A link to
                a Pascal source file using this DLL will look like this:
                <A HREF="/scrips/p2hisapi.dll?e:\public\pas\test.pas">,
                assuming you have copied the .DLL file to the scripts directory
                on your WEB server.

New versions
============

New versions of the program will become available via the Pas2HTML homepage
at http://www.coas.com/pas2html, and at the Borland Delphi forums at
CompuServe (GO DELPHI or GO BDELPHI32).


Problems?
=========

When you have any questions about the program, or find any bugs, you can
contact me via e-mail at pp@coas.com.


Registration
============

The command line version of Pascal to HTML is a free tool. If you want to
use the Windows interface version for a period longer than 30 days, you
should register. The registration fee for Pas2HTML is US$ 22.00 and can
be done by going to the SWREG forum on CompuServe (use ID #14568 to find the
program or search for pas2html). Once you have registered you will receive
the user-friendly Windows version of the program, which will also alow you
to influence the final output.


Version history:
================

2.0 - Fixed the folowing bugs:
        - Added correct handling of the Delphi 2.0 style // comments.
        - Changed the HTML output to achieve better compatibility with
          older WEB browser versions.
      Added the folowing new features:
        - A 16-bit windows version has been added.
        - An ISAPI WEB server version has been added.
      Added the folowing features to the registered version:
        - You can specify not to include the standard header and or footer.
1.0 - The initial release of the command line conversion tool.

