collateindex.pl(1)

collateindex.pl1

Generate docbook index files

Usage

collateindex.pl [-f] [-g] [-i id] [-I scope] [-N] [-o file] [-p] [-P file] [-q] [-s name] [-S scope] [-t name] [-x] file

Overview

collateindex.pl creates index data for DocBook XML or SGML files.

Options

-f

Force the output file to be written, even if it appears to have been edited by hand.

-g

Group terms with IndexDiv based on the first letter of the term (or its SortAs attribute). (This might not handle all language environments.)

-i id

The ID to use for the <index> tag.

-I scope

The implied scope, must be "all", "local", or "global". IndexTerms which do not specify a scope will have the implied scope. If unspecified, "all" is assumed.

-N

New index (generates an empty index file).

-o file

Output to file. Defaults to stdout.

-p

Link to points in the document. The default is to link to the closest containing section.

-P file

Read a preamble from file. The contents of file will be inserted before the <index> tag.

-q

Run quietly.

-s name

Name the IndexDiv that contains symbols. The default is "Symbols". Meaningless if -g is not used.

-S scope

Scope of the index, must be "all", "local", or "global". If unspecified, "all" is assumed.

-t name

Title for the index.

-x

Make a SetIndex.

-V

Print version number and exit.

file

The file containing index data generated with the DocBook DSSSL HTML stylesheet (usually called HTML.index).

Examples

collateindex.pl -o index.sgml HTML.index

Exit status

0

Success

1

Failure

Releases

14 releases since Debian 2.2 (Potato); the text changed 2 times.

  1. 2.2
  2. 3.0
  3. 3.1–Arch

-I since Debian 3.0 (Woody); -N since Debian 3.0 (Woody); -P since Debian 3.0 (Woody); -S since Debian 3.0 (Woody); -V since Debian 3.0 (Woody); -f since Debian 3.0 (Woody); -g since Debian 3.0 (Woody); -i since Debian 3.0 (Woody); -o since Debian 3.0 (Woody); -p since Debian 3.0 (Woody); -q since Debian 3.0 (Woody); -s since Debian 3.0 (Woody); -t since Debian 3.0 (Woody); -x since Debian 3.0 (Woody).