1 - Compiling HTMLDOC

This chapter describes the steps needed to compile HTMLDOC on your system.

Getting a Precompiled Executable

If you don't think you're up to compiling HTMLDOC, or you don't have the compiler and libraries listed below, consider downloading a precompiled version of HTMLDOC. Precompiled binaries are currently available for the following systems:

Requirements

HTMLDOC requires the following software and libraries:

C++ compiler (GCC will work)
JPEG library, version 6 or higher
PNG library, version 1.0.1 or higher
GZIP library (zlib), version 1.0.4 or higher
Fast Light Tool Kit (FLTK), version 19990107 or newer
X11 libraries, R5 or higher (UNIX only).

The GZIP library is used for reading PNG image files as well as writing compressed PDF files. GIF reading support is provided by HTMLDOC source code.

The JPEG library is used for reading JPEG image files as well as writing JPEG-compressed images in Level 2 PostScript and PDF output.

For the Microsoft Windows version of HTMLDOC you'll probably need Microsoft Visual C++ 5.0 or higher (other PC compilers may work; I didn't have much luck with Borland C++ 5.02).

Compiling under UNIX

If you are compiling for Windows, see "Compiling with the Visual C++ Project File".

HTMLDOC is built from a single Makefile in the distribution's main directory (htmldoc-1.7). To configure the Makefile for your system you must run the configure script:

% ./configure Enter

To compile HTMLDOC simply run the "make" command in the HTMLDOC directory. If you get any fatal errors please send a copy of the make/compiler output to "mike@easysw.com" for assistance. Please note the version of HTMLDOC that you are using as well as any pertinent system information (operating system, OS version, compiler, etc.)

Installing the Software

The Makefile built by the configure script supports installation of the program and man pages under /usr/local or a directory provided to the configure script using the "--prefix=directory" option.

To install HTMLDOC simply run the "make install" command as root.

Compiling with the Visual C++ Project File

A sample project file for Visual C++ 5.0 is included in the source distribution in the file htmldoc.dsp. You will need to change the include directories and libraries to point to the directories containing the JPEG, PNG, ZLIB, and FLTK libraries.