| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143 |
- This README.dev file gives some information about developing texi2html.
- Copyright 2010, 2015 Free Software Foundation, Inc.
- Copying and distribution of this file, with or without modification,
- are permitted in any medium without royalty provided the copyright
- notice and this notice are preserved.
- [incomplete]
- Customizing texi2html
- =====================
- Initialisation options are read first from
- '/usr/local/etc/texi2html/Config' (the exact location being changeable with
- the '--sysconfdir=dir' option to the configure script), then from
- $HOME/.texi2html/Config, then any command-line options including --init-file
- options; with later settings overriding earlier ones.
- The default initialisation options are defined in the
- 'texi2html.pm' and built-in formats files in formats/*.pm files
- contained in the Texi2html distribution (in fact, a script pastes
- those files into the beginning of the perl file generated by
- `./configure' from texi2html.pl and generates the actual 'texi2html'
- script this way.).
- To customize 'texi2html' it is best if you copy the appropriate
- sections from the 'texi2html.pm' file into an appropriate local
- initialization file, make the necessary changes there, and then have
- 'texi2html' read this initialisation file by one of the means described
- above.
- Documentation of texi2html
- ==========================
- The texi2html Texinfo manual is lagging behind the development. In
- addition, you might want to have a look at the comments in the
- 'texi2html.pm' file for explanations about customizable parameters
- and at the (not up-to-date) texi2html man page for an overview of
- texi2html's synopsis.
- Files
- =====
- This distribution includes the following files, among others:
- README This file.
- NEWS Summary of new features by release.
- INSTALL Generic installation instructions.
- TODO Things which are yet to be done.
- Texi2html source files:
- texi2html Actual script to run. Generated by
- make, `buildt2h.sh' and `addformats.sh'
- from texi2html.pl, texi2html.pm,
- MySimple.pm, T2h_i18n.pm, examples/l2h.init,
- translations.pl and formats/*.pm.
- texi2html.pl Main source file of the converter.
- texi2html_configured.pl File generated by `./configure' from
- texi2html.pl.
- texi2html.pm Default values of configurable
- parameters. `buildt2h.sh' inserts this
- file into texi2html_configured.pl when
- it generates the actual `texi2html' script.
- MySimple.pm Perl module which handles the
- processing of command-line options.
- `buildt2h.sh' inserts this file into
- texi2html_configured.pl when it generates
- the actual `texi2html' script.
- T2h_i18n.pm Code used to handle strings
- internationalization (obsolete).
- translations.pl translations of strings generated by
- the script `manage_i18n.pl' from source
- files and files in the `i18n' directory
- (obsolete).
- po_document/ Directory containing po files used for
- translation of strings. The primary source
- for the file are outside of texi2html,
- in the texinfo po_document/ directory.
- po_messages/ Directory containing po files used for
- translation of strings. The primary source
- for the file are outside of texi2html,
- in the texinfo po/ directory.
- i18n/ Directory containing one file per language
- with translation of strings (obsolete,
- generated from po_document/ files).
- Helper scripts
- gettext_to_separated.pl Helper scripts used to convert gettext po
- separated_to_hash.pl files to the former format used by texi2html
- up to version 1.82.
- manage_i18n.pl Helper script used to regenerate translations
- from the source files and the files in the
- `i18n/' directory.
- buildt2h.sh Helper script used to regenerate the texi2html
- script. A simple wrapper around a sed
- one-liner.
- addformats.sh Other helper script used to regenerate the
- texi2html script, for all the built-in formats.
- A simple wrapper around a sed one-liner.
-
- Documentation files:
- texi2html.texi Texinfo manual of texi2html.
- 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 the other files.
- configure.ac 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.
|
