Some system administrators do not allow Perl programs to run as shell scripts. This means that you may not be able to run any of the above programs. In this case change the first line in each of these programs from
#!/usr/local/bin/perl
to :
# *-*-perl-*-* eval 'exec perl -S $0 "$@"' if $running_under_some_shell;
While you're at it you may want to change some default options in the same file.
Don't forget to make install-test executable (using the chmod command) if necessary, before using it. You may also need to make the files pstogif, texexpand, configure-pstoimg and latex2html executable if install-test fails to do it for you.
If for any reason you have trouble running install-test do not despair. Most of what it does is to do with checking your installation rather than actually installing anything. To do a manual installation just change the variable $LATEX2HTMLDIR, in the beginning of the file latex2html, to point to the directory where the LATEX2HTML files can be found.
This Perl script creates a file called local.pm which contains
complete paths to the various utilities which pstoimg
will use as it generates graphics. This file can be edited later if new
the script fails to find a particular utility, or a new version
becomes available. In particular a variable $TMP can also be set
to indicate a temporary directory to use while generating images.
Alternatively variables can be assigned values on the
command-line; run
configure-pstoimg -help
to see the full range of options.
This is usually enough for the main installation, but you may also want to do some of the following, to ensure that advanced features of LATEX2HTML work correctly on your system:
If dvips does not support the -mode switch, then leave $DVIPS_MODE undefined, and verify that the .dvipsrc file points to the correct screen device and its resolution.
You can also set up a ``per directory'' initialization file by copying a version of .latex2html-init in each directory you would like it to be effective. An initialization file /X/Y/Z/.latex2html-init will take precedence over all other initialization files if /X/Y/Z is the ``current directory'' when LATEX2HTML is invoked.
Warning: This initialization file is incompatible with any version of LATEX2HTML prior to V96.1. Users must either update this file in their home directory, or delete it altogether.
Warnings: If you cannot do that, bear in mind that these icons will have to travel from Livermore, California!!! Also note that several more icons were added in V96.1 that were not present in earlier versions of LATEX2HTML.
make manual.dvi
This initiates the following sequence of commands:
latex manual.tex makeindex -s l2hidx.ist manual.idx makeindex -s l2hglo.ist -o manual.gls manual.glo latex manual.tex latex manual.tex...in which the two configuration files l2hidx.ist and l2hglo.ist for the makeindex program, are used to create the index and glossary respectively. The 2nd run of latex is needed to assimilate references, etc. and include the index and glossary.
Next, the HTML version is obtained by typing:
make manual.html
This initiates a series of calls to LATEX2HTML on the separate segments of the manual; the full manual is thus created as a ``segmented document'' (see a later section). The whole process may take quite some time, as each segment needs to be processed at least twice, to collect the cross-references from other segments.
The files necessary for correct typesetting of the manual to be
found within the docs/ subdirectory.
They are as follows:
The last three can be derived from the others, but are included for convenience.
{changes.tex}
within docs/manual.tex,
and comment-out the surrounding htmlonly environment.
Remake the manual as in the preceding item;
the repeated runs of latex are required to adjust the index,
glossary and table-of-contents for the extra information.
Up to 20 extra pages may be added.