     [file version.texi not included]
This file documents the texi2html script which converts Texinfo into HTML.

Copyright (C) 1999, 2000  Free Software Foundation, Inc.

This edition is for texi2html version VERSION, UPDATED.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.

Texi2html
*********

This Manual (Edition 0.21, last updated at 14. August 2000) describes the texi2html Perl script which converters Texinfo (see Texinfo) into HTML.

Please send bug reports about this manual to Karl Heinz Marbaise khmarbaise@gmx.de. Please state exact version/edition of the manual (can be found at start of Texinfo source file; use the entry Id under Revisions).

Please note:

     This manual is currently under
     construction and of course incomplete ;-)

Overview about texi2html
************************

Texinfo (http://www.texinfo.org) is the official documentation format of the GNU (http://www.gnu.org) project. It uses a single source file to produce both online information and printed output.

It is often proposed to have a way to produce HTML from Texinfo sources, like the GNU-Info format. It is much simpler to create one converter instead of writing all documentation new in HTML, cause there is so much documentation in Texinfo all over the world.

A few time ago makeinfo wasn't able to produce HTML output format, but there are needth to have HTML. This was the borning hour for texi2html. The basic purpose of texi2html is to convert Texinfo documents into HTML.

Ways to get HTML
================

You would like to HTML files out of your Texinfo files? There exist two ways which you can go. This first is to use makeinfo itself to produce HTML output. The second is to use texi2html.

Why texi2html and not makeinfo?
===============================

The basic idea of makeinfo's HTML output was to get an readable HTML output. Nothing sophisticated nor good styling just readable.

The current development of texi2html is going into different direction.

The main purpose is to get better styling, better design etc. of the created HTML pages. This way is supported using differnt command line options and of course possible changings of the initialization file to fit your own needs.

The main disadvantage of makeinfo's HTML output is your getting only one big file. This is of course readable but not very usable. The problem of this is, while you like to have splitted chapters or nodes the Texinfo source has to be read at minimum twice times. This makes it impossible to implement this in makeinfo. This would result in complete new implementation of makeinfo's source.

In contrast to the HTML produced by makeinfo --html (the makeinfo program is part of the Texinfo distribution), the HTML output of texi2html is highly configurable. Among other differences, with texi2html allows you to customize your entire page layout (like headers, footers, style sheets, etc), split documents at various levels, and use latex2html to convert @tex sections.

texi2html should reasonably convert all Texinfo 4.0 constructs. If not, please send a bug report to texi2html@mathematik.uni-kl.de.

Installation of texi2html
*************************

description of the installation process. What do you need? How?

Customizing files
*****************

Result based on using -frames

     texi2html -V -frames texi2html.texi

Explanation of the output differences against default, whatever this is ;-)

Customizing what gets expanded
******************************

Test starting.

-expand info -expand tex Take a look at optionexpand.

     [file custpage.texi not included]
     [file custhtml.texi not included]
     [file initfile.texi not included]
     [file ifo.texi not included]
     [file options.texi not included]
     [file reference.texi not included]

Indices
*******