(texi2html.info)Initialization files

---

Next: Changing the page layout Prev: Invoking texi2html Up: Top

---

Enter node , (file) or (file)node

5 Overview of initialization files content and loading
******************************************************

The initialization files are `perl' files, read as explained in Note:
Using init files. You don't need to know much of `perl' to do some
simple changes in variable values, however, to be able to really take
advantage of all the features of the initialization file, a good
knowledge of `perl' is required.

   In initialization file two kind of variables appear. These are normal
variables (including arrays and hashes) and references on functions.
The later permits the dynamic redefinition of functions used to produce
the HTML manual. You should be able to change the value of some normal
variables without a deep knowledge of `perl', by looking at the
existing examples. The possible mistakes in that case could be omitted
`;', and bad quoting.

   Initialization file are loaded from the main program by the mean of
a `require', while in the `Texi2HTML::Config' namespace. This means
that the namespace of the main program and the namespace of
initialization files are distinct, which ensures that no name clash
should happen. The variables are declared with `use vars', such that it
should be possible to use the `use strict' pragma in the initialization
file code.

   To avoid messing with the variables in the `main' namespace all the
global variables which could be of use in the init files are in the
`Texi2HTML' namespace. Notice that the functions of the main program
are still in the `main' namespace.

   Since `texi2html' can proceed more than one file on the command
line, you should make sure that you initialize the variables that are
used during a manual formatting. The handlers explained later can be
used for that (Note: Bypassing normal formatting).

Encodings

Setting the encodings.

Redefining functions

Function redefinition is achieved with

redefinition of references on functions.

Function prototypes

Conventions used in that manual for function

reference prototypes display.