HTML Tidy for OS/2
==================
 
Introduction
------------
 
This is HTML Tidy based on TidyLib and compiled for OS/2. HTML Tidy can check
(X)HTML and XML source code for compliance with several (X)HTML standards,
correct a number of errors automatically, format the code for better readability
in accordance with the user's wishes, provide hints regarding accessability,
convert between code pages, and even help to get rid of the bad things that
MS Word and other word processors do to documents that are exported to HTML.
 
 
OS/2 specifics
--------------
 
Support for codepage 850, which is required for most OS/2 installations, has
been added and included in the official CVS tree. Use the -ibm858 parameter
to activate it. IBM changed the ibm850 codepage on OS/2 to include the Euro
currency symbol, which actually makes it ibm858.
 
 
Installation and first steps
----------------------------
 
To install, copy the executables to your PATH. Also, emx 0.9d fix 4 must be
installed on your system. For documentation see http://tidy.sourceforge.net.
 
A help screen is availabe by invoking tidy.exe with the -h option. Note that not
all options can be configured via the command line. Try the following to see
what tidy can do:
 
  tidy -ic -ibm858 html_input_file > html_output_file
 
To use a configuration file, you can either use the -config parameter or set the
environment variable HTML_TIDY to point to it as in
 
  SET HTML_TIDY=e:/home/myuserid/.tidyrc
 
Note that Tidy does *not* like tabs in the HTML code. In that case, use the
included tool tab2space to convert them to spaces first. The number of spaces
that tabs are converted to can be changed. Furthermore, tab2space can convert
between DOS, Unix, and Mac-style line endings. A help screen is available by
invoking tab2space.exe with the -h option.
 
An excellent add-on that integrates Tidy into Emacs is available from
Kal Hodgson at: http://discus.anu.edu.au:80/~kahlil/emacs/tidy.el
 
 
Compiling
---------
 
The binaries in this package have been compiled from the source code for TidyLib
and the console front-end as it was available from the Tidy CVS archive on
October 5, 2004. See the section on TidyLib at http://tidy.sourceforge.net for more
information. Tidy only needs a few changes to build on OS/2:
 
  1. Added "typedef unsigned long ulong;" to the OS/2 specific section of
     platform.h.
 
  2. Changed "_O_BINARY" to "O_BINARY" in tidylib.c.
 
  3. Added "-Zexe" the CLFAGS in the Makefile.
 
Hopefully, these will find their way into the official code some day, albeit the
developers not having responded to my submissions and requests for quite a
while. Compiling was done with gcc 3.0.3.
 
 
Support
-------
 
If you notice any erroneous behaviour that is probably OS/2-related, please
contact me. I am especially interested in whether the UTF16 and Asian codepage
support works or not. Otherwise use the official mailing list, as I am not able
to provide general support. 
 
 
License
-------
 
See the file license that is included in this distribution archive.
 
 
----------------------------------------------------
Christian Hennecke <christian.hennecke@os2voice.org>
October 25, 2004