This chapter describes the steps needed to install HTMLDOC on
your system from any of the source or binary distributions.
Installing a Binary Distribution
HTMLDOC binary distributions are available for a number of UNIX and
Windows platforms.
Requirements
HTMLDOC requires approximately 2MB of disk space and one of the
following environments:
- Compaq Tru64 UNIX 4.0 or higher
- Digital UNIX 4.0 or higher
- HP-UX 10.20 or higher
- IRIX 5.3 or higher
- Linux 2.0 or higher
- Microsoft Windows 95
- Microsoft Windows 98
- Microsoft Windows NT 4.0
- Red Hat Linux 5.2 or higher
- Solaris 2.5 or higher
Installing HTMLDOC under Red Hat Linux
Run the following command to install HTMLDOC under Red Hat Linux:
% rpm -i htmldoc-1.8-linux-2.0.36-intel.rpm ENTER
Uninstalling HTMLDOC under Red Hat Linux
Run the following command to remove HTMLDOC from your Red Hat Linux
system:
% rpm -r htmldoc ENTER
Installing HTMLDOC under UNIX
Run the following commands to install HTMLDOC under UNIX:
% gunzip htmldoc-1.8-platform.tar.gz ENTER
% tar xf htmldoc-1.8-platform.tar ENTER
% ./setup ENTER
Substitute the correct platform string as needed.
Uninstalling HTMLDOC under UNIX
Run the following command to remove HTMLDOC from your UNIX system:
% /etc/software/htmldoc.remove ENTER
Installing HTMLDOC under Windows
HTMLDOC is provided in a self-extracting installation file under
Windows. Double-click on the setup icon to install HTMLDOC under Windows.
Uninstalling HTMLDOC under Windows
Open the Control Panel window and double-click on the Add/Remove Software
icon. When the available software list is displayed, select HTMLDOC and
click on the Remove button.
Installing HTMLDOC from the Source Distribution
The complete source to HTMLDOC is available to build HTMLDOC for
different directories, architectures, or operating systems.
Requirements
HTMLDOC requires ANSI C and C++ compilers (GCC/EGCS work fine.) To
build the GUI you'll also need:
Configuring the UNIX Source
HTMLDOC uses a configuration script produced by GNU autoconf to
configure itself for your system. If your ANSI C compiler is not called
cc or gcc, set the CC
environment
variable to the name and path of your ANSI C compiler:
% setenv CC /path/to/compiler [C Shell]
% CC=/path/to/compiler; export CC [Bourne/Korn Shell]
Similarly, if your C++ compiler is not called CC, gcc,
c++, or g++, set the CXX
environment
variable to the name and path of your C++ compiler:
% setenv CXX /path/to/compiler [C Shell]
% CXX=/path/to/compiler; export CXX [Bourne/Korn Shell]
Finally, if the FLTK library is not installed in a standard location for
your compilers, set the CFLAGS
, CXXFLAGS
, and
LDFLAGS
environment variables to point to the FLTK library:
% setenv CFLAGS -I/path/to/fltk [C Shell]
% setenv CXXFLAGS -I/path/to/fltk
% setenv LDFLAGS -L/path/to/fltk/lib
% CFLAGS=-I/path/to/fltk; export CFLAGS [Bourne/Korn Shell]
% CXXFLAGS=-I/path/to/fltk; export CXXFLAGS
% LDFLAGS=-L/path/to/fltk/lib; export LDFLAGS
Then run the following command to configure HTMLDOC for
installation in the default directories:
% ./configure ENTER
The default configuration will install HTMLDOC in the
/usr/bin directory with the data files under
/usr/share/htmldoc and the documentation and on-line help
under /usr/share/doc/htmldoc. Use the --prefix
option to change the installation prefix to /usr/local:
% ./configure --prefix=/usr/local ENTER
Compiling under UNIX
HTMLDOC is built from a Makefile in the distribution's main
directory. Simply run the "make" command to build HTMLDOC:
% make ENTER
If you get any fatal errors please send a copy of the make/compiler
output to "htmldoc-support@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 under UNIX
To install HTMLDOC simply run the "make install" command as root:
% make install ENTER
Compiling with Visual C++
A Visual C++ 6.0 workspace file and associated project files are
included in the source distribution under the "visualc" directory. Open
the workspace file "htmldoc.dsw", adjust the FLTK include and project
file locations, and then build the HTMLDOC target.
Installing with Visual C++
The Windows installation package is created using InstallShield for Visual C++
6. The "visualc/HTMLDOC" directory contains the installation information
for HTMLDOC needed to build a binary distribution with InstallShield.
To install HTMLDOC without InstallShield, create an
installation directory and copy the htmldoc.exe executable,
the afm directory, the data directory, and the
doc directory to it.
Then use the regedit program to create the following two string
entries:
HKEY_LOCAL_MACHINE\Software\Easy Software Products\HTMLDOC\data
- C:\installation\directory
HKEY_LOCAL_MACHINE\Software\Easy Software Products\HTMLDOC\doc
- C:\installation\directory\doc