<html>
<head>
<meta name='author' content='Easy Software Products'>
<meta name='copyright' content='Copyright 1997-2006, All Rights Reserved.'>
<meta name='docnumber' content='ESP-003-20060801'>
<title>HTMLDOC 1.8.27 Software Users Manual</title>
</head>
<body>
<!-- FOOTER RIGHT "IN-$CHAPTERPAGE" -->
<div align='justify'>
<h1 align='right'><a name='INTRO'>Introduction</a></h1>
<p>This document describes how to use the HTMLDOC software,
version 1.8.27. HTMLDOC converts Hyper-Text Markup Language
("HTML") input files into indexed HTML, Adobe®
PostScript®, or Adobe Portable Document Format ("PDF")
files.</p>
<p>HTMLDOC supports most HTML 3.2 elements, some HTML 4.0
elements, and can generate title and table of contents pages. It
does not currently support stylesheets.</p>
<p>HTMLDOC can be used as a standalone application, in a batch
document processing environment, or as a web-based report
generation application.</p>
<p>No restrictions are placed upon the output produced by
HTMLDOC.</p>
<p>HTMLDOC is available both as open source software under the
terms of the GNU General Public License and as commercial
software under the terms of a traditional commercial End-User
License Agreement.</p>
<h2>History</h2>
<p>Like many programs HTMLDOC was developed in response to a
need our company had for generating high-quality documentation
in printed and electronic forms. For a while we used
FrameMaker® and a package from <code>sgi</code> that
generated "compiled" Standard Generalized Markup Language
("SGML") files that could be used by the Electronic Book
Technologies ("EBT") documentation products; EBT was bought by
INSO who was bought by Stellent<sup>TM</sup> who apparently has
dropped the whole product line. When <code>sgi</code> stopped
supporting these tools we turned to INSO, but the cost of their
tools is prohibitive to small businesses.</p>
<p>In the end we decided to write our own program to generate
our documentation. HTML seemed to be the source format of choice
since WYSIWYG HTML editors are widely (and freely) available and
at worst you can use a plain text editor. We needed HTML output
for documentation on our web server, PDF for customers to read
and/or print from their computers, and PostScript for our own
printing needs.</p>
<p>The result of our efforts is the HTMLDOC software which is
available for Linux®/UNIX®, MacOS® X, and
Microsoft® Windows®. Among other things, this software
users manual is produced using HTMLDOC.</p>
<h2>Organization of This Manual</h2>
<p>This manual is organized into tutorial and reference chapters
and appendices:</p>
<ul>
<li><a href='#INSTALL'>Chapter 1</a> - Installing
HTMLDOC</li>
<li><a href='#STARTING'>Chapter 2</a> - Getting
Started</li>
<li><a href='#BOOKS'>Chapter 3</a> - Generating
Books</li>
<li><a href='#CMDLINE'>Chapter 4</a> - HTMLDOC from the
Command-Line</li>
<li><a href='#CGI'>Chapter 5</a> - HTMLDOC from a Web
Server</li>
<li><a href='#HTMLREF'>Chapter 6</a> - HTML
Reference</li>
<li><a href='#GUIREF'>Chapter 7</a> - GUI Reference</li>
<li><a href='#CMDREF'>Chapter 8</a> - Command-Line
Reference</li>
<li><a href='#LICENSE'>Appendix A</a> - License Agreement</li>
<li><a href='#BOOKFORMAT'>Appendix B</a> - Book File
Format</li>
<li><a href='#RELNOTES'>Appendix C</a> - Release
Notes</li>
<li><a href='#COMPILE'>Appendix D</a> - Compiling
HTMLDOC from Source</li>
</ul>
<h2>Support</h2>
<p>Commercial support is available from Easy Software Products
when you purchase the HTMLDOC Professional Membership. More
information is available at the HTMLDOC web page at the
following URL:</p>
<pre>
<a href="http://www.easysw.com/htmldoc/">http://www.easysw.com/htmldoc/</a>
</pre>
<h2>Encryption Support</h2>
<p>HTMLDOC includes code to encrypt PDF document files using the
RC4 algorithm with up to a 128-bit key. While this software and
code may be freely used and exported under current US laws,
other countries may restrict your use and possession of this
code and software.</p>
<h2>Copyright, Trademark, and License Information</h2>
<p>The Adobe Portable Document Format is Copyright 1985-2005 by
Adobe Systems Incorporated. Adobe, FrameMaker, and PostScript
are registered trademarks of Adobe Systems, Incorporated.</p>
<p>The Graphics Interchange Format is the copyright and
GIF<sup>SM</sup> is the service mark property of CompuServe
Incorporated.</p>
<p>Intel is a registered trademark of Intel Corporation.</p>
<p>Linux is a registered trademark of Linus Torvalds.</p>
<p>MacOS is a registered trademark of Apple Computer, Inc.</p>
<p>Microsoft and Windows are registered trademarks of Microsoft
Corporation.</p>
<p>Red Hat and RPM are registered trademarks of Red Hat,
Inc.</p>
<p>Solaris is a registered trademark of Sun Microsystems,
Inc.</p>
<p>SPARC is a registered trademark of SPARC International, Inc.</p>
<p>UNIX is a registered trademark of the X/Open Company,
Ltd.</p>
<p>HTMLDOC is the trademark property of Easy Software
Products.</p>
<p>HTMLDOC is copyright 1997-2006 by Easy Software Products. See
<a href='#LICENSE'>Appendix A - License Agreement</a> for the
terms of use.</p>
<p>This software is based in part on the work of the Independent
JPEG Group and FLTK project.</p>
</div>
</body>
</html>
