This is the README file for the GNU texi2html distribution.
The primary distribution point is
http://www.mathematik.uni-kl.de/~obachman/Texi2html/Distrib
For generic installation instructions on compiling and installing this
Automake-based distribution, please read the file `INSTALL'.
Installation notes specific to Texi2html:
* Installation is fairly simple, no compilers are required.
* You need to have perl version 5 or higher installed on your system
to run 'texi2html'.
* To generate Makefile.in etc., run `./autogen.sh'
This distribution includes the following files, among others:
README This file.
NEWS Summary of new features by release.
INTRODUCTION Brief introduction to texi2html and
its usage.
INSTALL Generic installation instructions.
TODO Things which are yet to be done.
Texi2html source files:
texi2html Actual script to run. Generated by
'configure' from texi2html.pl,
texi2html.init, and MySimple.pm.
texi2html.pl Main source file of the converter.
texi2html.init Default values of configurable
parameters. `configure' inserts this
file into texi2html.pl when it generates
the actual `texi2html' script.
MySimple.pm Perl module which handles the
processing of command-line options.
`configure' inserts this file into
texi2html.pl when it generates
the actual `texi2html' script.
Documentation files:
texi2html.texi Texinfo manual of texi2html. This
manual is currently und construction.
texi2html.1.in Template for generation of man pages
of texi2html (`texi2html.1'). This man
page is incomplete.
Installation files:
configure This file creates creates a Makefile
which in turn creates an `info' or
`makeinfo' executable, or a C sources
distribution.
configure.in This is a template for creating
`configure' using Autoconf.
Makefile.in This is a template for `configure'
to use to make a Makefile. Created by
Automake.
Makefile.am This is a template for Automake
to use to make a Makefile.in.
WWW home page:
http://www.mathematik.uni-kl.de/~obachman/Texi2html/
Mailing lists:
- texi2html@mathematik.uni-kl.de for bug reports, enhancement
suggestions, authoring questions and general discussion.
- to subscribe to this mailinglist, send an email to
majordomo@mathematik.uni-kl.de with the mail body
'subscribe texi2html' (without the quotes).
There is as yet no corresponding newsgroup.
For bug reports, please include enough information for the maintainers
to reproduce the problem. Generally speaking, that means:
- the version number of Texi2html and the program(s) involved (use --version).
- the contents of any input files necessary to reproduce the bug (crucial!).
- a description of the problem and any samples of the erroneous output.
- anything else that you think would be helpful.
Patches are most welcome; if possible, please make them against the
source files (e.g., against texi2html.pl, or texi2html.init) with
'diff -c' and include ChangeLog entries.
When sending email, please do not encode or split the messages in any
way if at all possible; it's much easier to deal with one large message
than many small ones. GNU shar is a convenient way of packaging
multiple and/or binary files for email.