-*-Text-*-
***WARNING***: Do NOT edit this file. It was created automatically from
the corresponding .HLP file:
makeindex.vms
by the vmshelp2 utility on Tue Dec 10 07:34:30 1991
File: makeindex, Node: Top, Previous: MAKEINDEX, Up: (dir), Next: MAKEINDEX
* Menu:
* MAKEINDEX::
File: makeindex, Node: MAKEINDEX, Previous: Top, Up: Top, Next: Top
MAKEINDEX
* Menu:
* NAME-[MAKEINDEX]::
* SYNOPSIS-[MAKEINDEX]::
* DESCRIPTION-[MAKEINDEX]::
* The program makeindex is a general purpose hierarchical-[MAKEINDEX]::
* Kernighan, which is specific to troff(1), generates non--[MAKEINDEX]::
* The formats of the input and output files are specified in a-[MAKEINDEX]::
* Unless specified explicitly, the base name of the first-[MAKEINDEX]::
* For important notes on how to select index keywords, see the-[MAKEINDEX]::
* OPTIONS-[MAKEINDEX]::
* STYLE FILE-[MAKEINDEX]::
* The style file informs makeindex about the format of the-[MAKEINDEX]::
* The style file contains a list of -[MAKEINDEX]::
* Pairs do not have to appear in any particular order. A line-[MAKEINDEX]::
* A literal backslash or quote must be escaped (by a-[MAKEINDEX]::
* EXAMPLES-[MAKEINDEX]::
* The following example shows a style file called book.ist,-[MAKEINDEX]::
* Assuming that a particular book style requires the index (as-[MAKEINDEX]::
* Here a non-default output file name is used to avoid-[MAKEINDEX]::
* A sample control file for creating an index, which we will-[MAKEINDEX]::
* The local macro package may require modification, as in this-[MAKEINDEX]::
* Note that index entries are indicated by the .IX macro,-[MAKEINDEX]::
* To create an input file for makeindex, in the Bourne shell-[MAKEINDEX]::
* Some sites will require ditroff instead of psroff. To-[MAKEINDEX]::
* With UCSF Enhanced troff/TRANSCRIPT, the -I option of-[MAKEINDEX]::
* If it is wished to suppress the formatter output-[MAKEINDEX]::
* Any of the above procedures leaves the input for makeindex-[MAKEINDEX]::
* This leaves troff(1)-ready output in the file sample.ind.-[MAKEINDEX]::
* ORDERING-[MAKEINDEX]::
* By default, makeindex assumes word ordering; if the -l-[MAKEINDEX]::
* Numbers are always sorted in numeric order. For instance,-[MAKEINDEX]::
* Letters are first sorted without regard to case; when words-[MAKEINDEX]::
* A special symbol is defined here to be any character not-[MAKEINDEX]::
* SPECIAL EFFECTS-[MAKEINDEX]::
* Entries such as-[MAKEINDEX]::
* It is possible to make an item appear in a designated form-[MAKEINDEX]::
* The item, subitem, and subsubitem fields may have individual-[MAKEINDEX]::
* This will be converted to-[MAKEINDEX]::
* It is possible to encapsulate a page number with a desig--[MAKEINDEX]::
* The encap operator can also be used to create cross refer--[MAKEINDEX]::
* Note that in a cross reference like this the page number-[MAKEINDEX]::
* A pair of encap concatenated with range_open (`|(') and-[MAKEINDEX]::
* Intermediate pages indexed by the same key will be merged-[MAKEINDEX]::
* Several potential problems are worth mentioning. First,-[MAKEINDEX]::
* Finally, every special symbol mentioned in this section may-[MAKEINDEX]::
* From version 2.11 of makeindex, the quote operator may quote-[MAKEINDEX]::
* The sorting order is-[MAKEINDEX]::
* Here is an example showing the indexing of all printable-[MAKEINDEX]::
* ASCII characters other than letters and digits, assuming the-[MAKEINDEX]::
* Characters in the actual fields following the `@' character-[MAKEINDEX]::
* FILES-[MAKEINDEX]::
* SEE ALSO-[MAKEINDEX]::
* UCSF Enhanced troff/TRANSCRIPT - An Overview, R. P. C. Rodg--[MAKEINDEX]::
* School of Pharmacy, San Francisco, 1990.-[MAKEINDEX]::
* Index Preparation and Processing, Pehong Chen and Michael A.-[MAKEINDEX]::
* Harrison, Software-[MAKEINDEX]:: Practice and Experience, 19(9), 897915,
* September 1988.-[MAKEINDEX]::
* Automating Index Preparation, Pehong Chen and Michael A.-[MAKEINDEX]::
* Harrison. Technical Report 87/347, Computer Science Divi--[MAKEINDEX]::
* MakeIndex-[MAKEINDEX]:: An Index Processor for LaTeX, Leslie Lamport,
* February 1987 (a LaTeX document supplied with makeindex).-[MAKEINDEX]::
* Tools for Printing Indices, Jon L. Bentley and Brian W. Ker--[MAKEINDEX]::
* Computing Science Technical Report No. 128, AT&T Bell-[MAKEINDEX]::
* Laboratories, Murray Hill, NJ 07974, 1986).-[MAKEINDEX]::
* AUTHOR-[MAKEINDEX]::
* Pehong Chen, Chen & Harrison International Systems, Inc.-[MAKEINDEX]::
* Palo Alto, California, USA .-[MAKEINDEX]::
* Manual page extensively revised and corrected, and troff(1)-[MAKEINDEX]::
* ACKNOWLEDGMENTS-[MAKEINDEX]::
* Leslie Lamport contributed significantly to the design.-[MAKEINDEX]::
* Michael Harrison provided valuable comments and suggestions.-[MAKEINDEX]::
* Nelson Beebe improved on the portable version, and maintains-[MAKEINDEX]::
* Brosig contributed to the German word ordering. The modifi--[MAKEINDEX]::
* TRIB files in the makeindex source distribution record other-[MAKEINDEX]::
File: makeindex, Node: NAME-[MAKEINDEX], Previous: MAKEINDEX, Up: MAKEINDEX, Next: SYNOPSIS-[MAKEINDEX]
NAME
makeindex - a general purpose, formatter-independent index
processor
File: makeindex, Node: SYNOPSIS-[MAKEINDEX], Previous: NAME-[MAKEINDEX], Up: MAKEINDEX, Next: DESCRIPTION-[MAKEINDEX]
SYNOPSIS
makeindex [-c] [-g] [-i] [-l] [-o ind] [-p num] [-q] [-r]
[-s sfile] [-t log] [idx0 idx1 idx2...]
File: makeindex, Node: DESCRIPTION-[MAKEINDEX], Previous: SYNOPSIS-[MAKEINDEX], Up: MAKEINDEX, Next: The program makeindex is a general purpose hierarchical-[MAKEINDEX]
DESCRIPTION
File: makeindex, Node: The program makeindex is a general purpose hierarchical-[MAKEINDEX], Previous: DESCRIPTION-[MAKEINDEX], Up: MAKEINDEX, Next: Kernighan, which is specific to troff(1), generates non--[MAKEINDEX]
The program makeindex is a general purpose hierarchical
index generator; it accepts one or more input files (often
produced by a text formatter such as TeX (tex(1L)) or
troff(1), sorts the entries, and produces an output file
which can be formatted. The index can have up to three lev-
els (0, 1, and 2) of subitem nesting. The way in which
words are flagged for indexing within the main document is
specific to the formatter used; makeindex does not automate
the process of selecting these words. As the output index
is hierarchical, makeindex can be considered complimentary
to the awk(1)-based make.index(1L) system of Bentley and
File: makeindex, Node: Kernighan, which is specific to troff(1), generates non--[MAKEINDEX], Previous: The program makeindex is a general purpose hierarchical-[MAKEINDEX], Up: MAKEINDEX, Next: The formats of the input and output files are specified in a-[MAKEINDEX]
Kernighan, which is specific to troff(1), generates non-
hierarchical indices, and employs a much simpler syntax for
indicating index entries. For illustration of use with
troff and TeX, see the section EXAMPLES below.
File: makeindex, Node: The formats of the input and output files are specified in a-[MAKEINDEX], Previous: Kernighan, which is specific to troff(1), generates non--[MAKEINDEX], Up: MAKEINDEX, Next: Unless specified explicitly, the base name of the first-[MAKEINDEX]
The formats of the input and output files are specified in a
style file; by default, input is assumed to be a .idx file,
as generated by LaTeX.
File: makeindex, Node: Unless specified explicitly, the base name of the first-[MAKEINDEX], Previous: The formats of the input and output files are specified in a-[MAKEINDEX], Up: MAKEINDEX, Next: For important notes on how to select index keywords, see the-[MAKEINDEX]
Unless specified explicitly, the base name of the first
input file (idx0) is used to determine the names of other
files. For each input file name specified, a file of that
name is sought. If this file is not found and the file name
has no extension, the extension .idx is appended. If no
file with this name is found, makeindex aborts.
File: makeindex, Node: For important notes on how to select index keywords, see the-[MAKEINDEX], Previous: Unless specified explicitly, the base name of the first-[MAKEINDEX], Up: MAKEINDEX, Next: OPTIONS-[MAKEINDEX]
For important notes on how to select index keywords, see the
document by Lamport cited below. As an issue separate from
selecting index keywords, a systematic mechanism for placing
index terms in a document is suggested in Index Preparation
and Processing, a paper cited below.
File: makeindex, Node: OPTIONS-[MAKEINDEX], Previous: For important notes on how to select index keywords, see the-[MAKEINDEX], Up: MAKEINDEX, Next: STYLE FILE-[MAKEINDEX]
OPTIONS
-c Compress intermediate blanks (ignoring leading and
trailing blanks and tabs). By default, blanks in
the index key are retained.
-g Employ German word ordering in the index, in
accord with rules set forth in DIN 5007. By
default, makeindex employs a word ordering in
which precedence is: symbols, numbers, uppercase
letters, lowercase letters. The sequence in
German word ordering is: symbols, lowercase
letters, uppercase letters, numbers. Addition-
ally, this option enables makeindex to recognize
the German TeX-commands {"a, "o, "u and "s} as
{ae, oe, ue and ss} during the sorting of the
entries. The quote character must be redefined in
a style file (for example, redefine quote as '+').
If the quote character is not redefined, makeindex
will produce an error message and abort.
-i Take input from stdin. When this option is speci-
fied and -o is not, output is written to stdout.
-l Letter ordering; by default, word ordering is used
(see the ORDERING section).
-o ind Employ ind as the output index file. By default,
the file name is created by appending the exten-
sion .ind to the base name of the first input file
(idx0).
-p num Set the starting page number of the output index
file to be num (useful when the index file is to
be formatted separately). The argument num may be
numerical or one of the following:
any The starting page is the last source
page number plus 1.
odd The starting page is the first odd page
following the last source page number.
even The starting page is the first even page
following the last source page number.
The last source page is obtained by searching
backward in the log file for the first instance of
a number included within paired square brackets
([...]). If a page number is missing or the log
file is not found, no attempt will be made to set
the starting page number. The source log file
name is determined by appending the extension .log
to the base name of the first input file (idx0).
-q Quiet mode; send no messages to stderr. By
default, progress and error messages are sent to
stderr as well as to the transcript file.
-r Disable implicit page range formation; page ranges
must be created by using explicit range operators;
see SPECIAL EFFECTS below. By default, three or
more successive pages are automatically
abbreviated as a range (e.g. 1-5).
-s sty Employ sty as the style file (no default). The
environment variable INDEXSTYLE defines the path
where the style file should be found.
-t log Employ log as the transcript file. By default,
the file name is created by appending the exten-
sion .ilg to the base name of the first input file
(idx0).
File: makeindex, Node: STYLE FILE-[MAKEINDEX], Previous: OPTIONS-[MAKEINDEX], Up: MAKEINDEX, Next: The style file informs makeindex about the format of the-[MAKEINDEX]
STYLE FILE
File: makeindex, Node: The style file informs makeindex about the format of the-[MAKEINDEX], Previous: STYLE FILE-[MAKEINDEX], Up: MAKEINDEX, Next: The style file contains a list of -[MAKEINDEX]
The style file informs makeindex about the format of the
.idx input files and the intended format of the final output
file; examples appear below. This file can reside anywhere
in the path defined by the environment variable INDEXSTYLE.
File: makeindex, Node: The style file contains a list of -[MAKEINDEX], Previous: The style file informs makeindex about the format of the-[MAKEINDEX], Up: MAKEINDEX, Next: Pairs do not have to appear in any particular order. A line-[MAKEINDEX]
The style file contains a list of
pairs. There are two types of specifiers: input and output.
File: makeindex, Node: Pairs do not have to appear in any particular order. A line-[MAKEINDEX], Previous: The style file contains a list of -[MAKEINDEX], Up: MAKEINDEX, Next: A literal backslash or quote must be escaped (by a-[MAKEINDEX]
Pairs do not have to appear in any particular order. A line
begun by `%' is a comment. In the following list of specif-
iers and arguments, is an arbitrary string delim-
ited by double quotes ("..."), is a single letter
embraced by single quotes ('...'), and is a nonne-
gative integer. The maximum length of a is 2048.
File: makeindex, Node: A literal backslash or quote must be escaped (by a-[MAKEINDEX], Previous: Pairs do not have to appear in any particular order. A line-[MAKEINDEX], Up: MAKEINDEX, Next: EXAMPLES-[MAKEINDEX]
A literal backslash or quote must be escaped (by a
backslash). Anything not specified in the style file will
be assigned a default value, which is shown at the head of
the rightmost column.
* Menu:
* INPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]]::
* OUTPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]]::
File: makeindex, Node: INPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]], Previous: A literal backslash or quote must be escaped (by a-[MAKEINDEX], Up: A literal backslash or quote must be escaped (by a-[MAKEINDEX], Next: OUTPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]]
INPUT STYLE SPECIFIERS
actual '@'
Symbol indicating that the next
entry is to appear in the output
file.
arg_close '}'
Closing delimiter for the index
entry argument.
arg_open '{'
Opening delimiter for the index
entry argument.
encap '|'
Symbol indicating that the rest of
the argument list is to be used as
the encapsulating command for the
page number.
escape '\\'
Symbol which escapes the following
letter, unless its preceding letter
is escape. Note: quote is used to
escape the letter which immediately
follows it, but if it is preceded
by escape, it is treated as a ordi-
nary character. These two symbols
must be distinct.
keyword "\\indexentry"
Command which tells makeindex that
its argument is an index entry.
level '!'
Delimiter denoting a new level of
subitem.
quote '"'
Note: quote is used to escape the
letter which immediately follows
it, but if it is preceded by
escape, it is treated as a ordinary
character. These two symbols must
be distinct.
range_close ')'
Closing delimiter indicating the
end of an explicit page range.
range_open '('
Opening delimiter indicating the
beginning of an explicit page
range.
File: makeindex, Node: OUTPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]], Previous: INPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]], Up: A literal backslash or quote must be escaped (by a-[MAKEINDEX], Next: A literal backslash or quote must be escaped (by a-[MAKEINDEX]
OUTPUT STYLE SPECIFIERS
preamble "\\begin{theindex}\n"
Preamble of output file.
postamble "\n\n\\end{theindex}\n"
Postamble of output file.
setpage_prefix "\n \\setcounter{page}{"
Prefix of command which sets the
starting page number.
setpage_suffix "}\n"
Suffix of command which sets the
starting page number.
group_skip "\n\n \\indexspace\n"
Vertical space to be inserted
before a new group begins.
headings_flag 0
Flag indicating treatment of new
group headers, which are inserted
when before a new group (symbols,
numbers, and the 26 letters): posi-
tive values cause an uppercase
letter to be inserted between pre-
fix and suffix, and negative values
cause a lowercase letter to be
inserted (default is 0, which pro-
duces no header).
heading_prefix ""
Header prefix to be inserted before
a new letter begins.
symhead_positive
"Symbols"
Heading for symbols to be inserted
if headings_flag is positive.
symhead_negative
"symbols"
Heading for symbols to be inserted
if headings_flag is negative.
numhead_positive
"Numbers"
Heading for numbers to be inserted
if headings_flag is positive.
numhead_negative
"numbers"
Heading for numbers to be inserted
if headings_flag is negative.
item_0 "\n \\item "
Command to be inserted between two
primary (level 0) items.
item_1 "\n \\subitem "
Command to be inserted between two
secondary (level 1) items.
item_2 "\n \\subsubitem "
Command to be inserted between two
level 2 items.
item_01 "\n \\subitem "
Command to be inserted between a
level 0 item and a level 1 item.
item_x1 "\n \\subitem "
Command to be inserted between a
level 0 item and a level 1 item,
where the level 0 item does not
have associated page numbers.
item_12 "\n \\subsubitem "
Command to be inserted between a
level 1 item and a level 2 item.
item_x2 "\n \\subsubitem "
Command to be inserted between a
level 1 item and a level 2 item,
where the level 1 item does not
have associated page numbers.
delim_0 ", "
Delimiter to be inserted between a
level 0 key and its first page
number (default: comma followed by
a blank).
delim_1 ", "
Delimiter to be inserted between a
level 1 key and its first page
number (default: comma followed by
a blank).
delim_2 ", "
Delimiter to be inserted between a
level 2 key and its first page
number (default: comma followed by
a blank).
delim_n ", "
Delimiter to be inserted between
two page numbers for the same key
in any level (default: comma fol-
lowed by a blank).
delim_r "--"
Delimiter to be inserted between
the starting and ending page
numbers of a range.
delim_t ""
Delimiter to be inserted at the end
of a page list. This delimiter has
no effect on entries which have no
associated page list.
encap_prefix "\\"
First part of prefix for the
command which encapsulates the page
number.
encap_infix "{"
Second part of prefix for the com-
mand which encapsulates the page
number.
encap_suffix "}".
Suffix for the command which encap-
sulates the page number.
line_max 72
Maximum length of a line in the
output, beyond which a line wraps.
indent_space "\t\t"
Space to be inserted in front of a
wrapped line (default: two tabs).
indent_length 16
Length of indent_space (default:
16, equivalent to 2 tabs).
File: makeindex, Node: EXAMPLES-[MAKEINDEX], Previous: A literal backslash or quote must be escaped (by a-[MAKEINDEX], Up: MAKEINDEX, Next: The following example shows a style file called book.ist,-[MAKEINDEX]
EXAMPLES
* Menu:
* TeX EXAMPLE-[EXAMPLES-[MAKEINDEX]]::
File: makeindex, Node: TeX EXAMPLE-[EXAMPLES-[MAKEINDEX]], Previous: EXAMPLES-[MAKEINDEX], Up: EXAMPLES-[MAKEINDEX], Next: EXAMPLES-[MAKEINDEX]
TeX EXAMPLE
File: makeindex, Node: The following example shows a style file called book.ist,-[MAKEINDEX], Previous: EXAMPLES-[MAKEINDEX], Up: MAKEINDEX, Next: Assuming that a particular book style requires the index (as-[MAKEINDEX]
The following example shows a style file called book.ist,
which defines an index for a book which can be formatted
independently of the main source:
preamble
"\\documentstyle[12pt]{book}
\\begin{document}
\\begin{theindex}
{\\small\n"
postamble
"\n\n}
\\end{theindex}
\\end{document}\n"
File: makeindex, Node: Assuming that a particular book style requires the index (as-[MAKEINDEX], Previous: The following example shows a style file called book.ist,-[MAKEINDEX], Up: MAKEINDEX, Next: Here a non-default output file name is used to avoid-[MAKEINDEX]
Assuming that a particular book style requires the index (as
well as any chapters) to start from an odd page number, and
that the input file is named foo.idx, the following command
line produces output in file footmp.ind:
makeindex -s book.ist -o footmp.ind -p odd foo
File: makeindex, Node: Here a non-default output file name is used to avoid-[MAKEINDEX], Previous: Assuming that a particular book style requires the index (as-[MAKEINDEX], Up: MAKEINDEX, Next: A sample control file for creating an index, which we will-[MAKEINDEX]
Here a non-default output file name is used to avoid
clobbering the output for the book itself (presumably
foo.dvi, which would have been the default name for the
index output file!).
* Menu:
* TROFF EXAMPLE-[Here a non-default output file name is used to avoid-[MAKEINDEX]]::
File: makeindex, Node: TROFF EXAMPLE-[Here a non-default output file name is used to avoid-[MAKEINDEX]], Previous: Here a non-default output file name is used to avoid-[MAKEINDEX], Up: Here a non-default output file name is used to avoid-[MAKEINDEX], Next: Here a non-default output file name is used to avoid-[MAKEINDEX]
TROFF EXAMPLE
File: makeindex, Node: A sample control file for creating an index, which we will-[MAKEINDEX], Previous: Here a non-default output file name is used to avoid-[MAKEINDEX], Up: MAKEINDEX, Next: The local macro package may require modification, as in this-[MAKEINDEX]
A sample control file for creating an index, which we will
assume resides in the file sample.ist:
keyword "IX:"
preamble
".\\\" start of index output
\".\\\" enter two column mode
.2C
.SH
.ce
INDEX
.XS
INDEX
.XE
.R
.ps 9p
.vs 11p
.sp
.de I1
.ti 0.25i
..
.de I2
.ti 0.5i
.."
postamble "\n.\\\" end of index output"
setpage_prefix "\n.nr % "
setpage_suffix ""
group_skip "\n.sp 1.0"
headings_flag 1
heading_prefix "\n.IS\n"
heading_suffix "\n.IE"
item_0 "\n.br\n"
item_1 "\n.I1\n"
item_2 "\n.I2\n"
item_01 "\n.I1\n"
item_x1 "\n.I1\n"
item_12 "\n.I2\n"
item_x2 "\n.I2\n"
delim_0 ", "
delim_1 ", "
delim_2 ", "
delim_r "-"
delim_t "."
encap_prefix "\\fB"
encap_infix ""
encap_suffix "\\fP"
indent_space ""
indent_length 0
File: makeindex, Node: The local macro package may require modification, as in this-[MAKEINDEX], Previous: A sample control file for creating an index, which we will-[MAKEINDEX], Up: MAKEINDEX, Next: Note that index entries are indicated by the .IX macro,-[MAKEINDEX]
The local macro package may require modification, as in this
example of an extension to the -ms macros (note that at some
sites, this macro should replace a pre-existing macro of the
same name):
.
.de IX
.ie '\\n(.z'' .tm IX: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 {\\n(PN}
.el \\!.IX \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 {\\n(PN}
..
(note that the string {\\n(PN} is separated from the rest of
the line by a tab. If your local macro package does not
contain this extension, just include those lines at the
beginning of your file. Here is a simple troff(1) input
file, which we will assume is named sample.txt:
This is a sample file to test the \fImakeindex\fP(1L)
program, and see
.IX {indexing!programs!C language}
.IX {makeindex@\fImakeindex\fP(1L)}
.bp
.rs
.IX {Knuth}
.IX {typesetting!computer-aided}
how well it functions in the \fItroff\fP(1) environment.
File: makeindex, Node: Note that index entries are indicated by the .IX macro,-[MAKEINDEX], Previous: The local macro package may require modification, as in this-[MAKEINDEX], Up: MAKEINDEX, Next: To create an input file for makeindex, in the Bourne shell-[MAKEINDEX]
Note that index entries are indicated by the .IX macro,
which causes the following text to be written to stdout
along with the current page number.
* Menu:
* CREATING THE INDEX FILE IN THE BOURNE SHELL-[Note that index entries are indicated by the .IX macro,-[MAKEINDEX]]::
File: makeindex, Node: CREATING THE INDEX FILE IN THE BOURNE SHELL-[Note that index entries are indicated by the .IX macro,-[MAKEINDEX]], Previous: Note that index entries are indicated by the .IX macro,-[MAKEINDEX], Up: Note that index entries are indicated by the .IX macro,-[MAKEINDEX], Next: Note that index entries are indicated by the .IX macro,-[MAKEINDEX]
CREATING THE INDEX FILE IN THE BOURNE SHELL
File: makeindex, Node: To create an input file for makeindex, in the Bourne shell-[MAKEINDEX], Previous: Note that index entries are indicated by the .IX macro,-[MAKEINDEX], Up: MAKEINDEX, Next: Some sites will require ditroff instead of psroff. To-[MAKEINDEX]
To create an input file for makeindex, in the Bourne shell
environment, do the equivalent at your site of the command:
psroff -ms -Tpsc -t sample.txt > /dev/null 2> sample.tmp
File: makeindex, Node: Some sites will require ditroff instead of psroff. To-[MAKEINDEX], Previous: To create an input file for makeindex, in the Bourne shell-[MAKEINDEX], Up: MAKEINDEX, Next: With UCSF Enhanced troff/TRANSCRIPT, the -I option of-[MAKEINDEX]
Some sites will require ditroff instead of psroff. To
filter out any genuine error messages, invoke grep(1):
grep '^IX: ' sample.tmp > sample.idx
* Menu:
* CREATING THE INDEX FILE USING UCSF ENHANCED TROFF/TRANSCRIPT-[Some sites will require ditroff instead of psroff. To-[MAKEINDEX]]::
File: makeindex, Node: CREATING THE INDEX FILE USING UCSF ENHANCED TROFF/TRANSCRIPT-[Some sites will require ditroff instead of psroff. To-[MAKEINDEX]], Previous: Some sites will require ditroff instead of psroff. To-[MAKEINDEX], Up: Some sites will require ditroff instead of psroff. To-[MAKEINDEX], Next: Some sites will require ditroff instead of psroff. To-[MAKEINDEX]
CREATING THE INDEX FILE USING UCSF ENHANCED TROFF/TRANSCRIPT
File: makeindex, Node: With UCSF Enhanced troff/TRANSCRIPT, the -I option of-[MAKEINDEX], Previous: Some sites will require ditroff instead of psroff. To-[MAKEINDEX], Up: MAKEINDEX, Next: If it is wished to suppress the formatter output-[MAKEINDEX]
With UCSF Enhanced troff/TRANSCRIPT, the -I option of
psroff(1L) can produce both formatter output and an index
file:
psroff -ms -I sample.inp -Tpsc sample.txt
File: makeindex, Node: If it is wished to suppress the formatter output-[MAKEINDEX], Previous: With UCSF Enhanced troff/TRANSCRIPT, the -I option of-[MAKEINDEX], Up: MAKEINDEX, Next: Any of the above procedures leaves the input for makeindex-[MAKEINDEX]
If it is wished to suppress the formatter output:
psroff -ms -I sample.inp -Tpsc -t sample.txt > /dev/null
* Menu:
* COMPLETING THE INDEX-[If it is wished to suppress the formatter output-[MAKEINDEX]]::
File: makeindex, Node: COMPLETING THE INDEX-[If it is wished to suppress the formatter output-[MAKEINDEX]], Previous: If it is wished to suppress the formatter output-[MAKEINDEX], Up: If it is wished to suppress the formatter output-[MAKEINDEX], Next: If it is wished to suppress the formatter output-[MAKEINDEX]
COMPLETING THE INDEX
File: makeindex, Node: Any of the above procedures leaves the input for makeindex-[MAKEINDEX], Previous: If it is wished to suppress the formatter output-[MAKEINDEX], Up: MAKEINDEX, Next: This leaves troff(1)-ready output in the file sample.ind.-[MAKEINDEX]
Any of the above procedures leaves the input for makeindex
in sample.inp. The next step is to invoke makeindex:
makeindex -s sample.ist sample.idx
File: makeindex, Node: This leaves troff(1)-ready output in the file sample.ind.-[MAKEINDEX], Previous: Any of the above procedures leaves the input for makeindex-[MAKEINDEX], Up: MAKEINDEX, Next: ORDERING-[MAKEINDEX]
This leaves troff(1)-ready output in the file sample.ind.
File: makeindex, Node: ORDERING-[MAKEINDEX], Previous: This leaves troff(1)-ready output in the file sample.ind.-[MAKEINDEX], Up: MAKEINDEX, Next: By default, makeindex assumes word ordering; if the -l-[MAKEINDEX]
ORDERING
File: makeindex, Node: By default, makeindex assumes word ordering; if the -l-[MAKEINDEX], Previous: ORDERING-[MAKEINDEX], Up: MAKEINDEX, Next: Numbers are always sorted in numeric order. For instance,-[MAKEINDEX]
By default, makeindex assumes word ordering; if the -l
option is in effect, letter ordering is used. In word ord-
ering, a blank precedes any letter in the alphabet, whereas
in letter ordering, it does not count at all. This is
illustrated by the following example:
word order letter order
sea lion seal
seal sea lion
File: makeindex, Node: Numbers are always sorted in numeric order. For instance,-[MAKEINDEX], Previous: By default, makeindex assumes word ordering; if the -l-[MAKEINDEX], Up: MAKEINDEX, Next: Letters are first sorted without regard to case; when words-[MAKEINDEX]
Numbers are always sorted in numeric order. For instance,
9 (nine), 123
10 (ten), see Derek, Bo
File: makeindex, Node: Letters are first sorted without regard to case; when words-[MAKEINDEX], Previous: Numbers are always sorted in numeric order. For instance,-[MAKEINDEX], Up: MAKEINDEX, Next: A special symbol is defined here to be any character not-[MAKEINDEX]
Letters are first sorted without regard to case; when words
are identical, the uppercase version precedes its lowercase
counterpart.
File: makeindex, Node: A special symbol is defined here to be any character not-[MAKEINDEX], Previous: Letters are first sorted without regard to case; when words-[MAKEINDEX], Up: MAKEINDEX, Next: SPECIAL EFFECTS-[MAKEINDEX]
A special symbol is defined here to be any character not
appearing in the union of digits and the English alphabetic
characters. Patterns starting with special symbols precede
numbers, which precede patterns starting with letters. As a
special case, a string starting with a digit but mixed with
non-digits is considered to be a pattern starting with a
special character.
File: makeindex, Node: SPECIAL EFFECTS-[MAKEINDEX], Previous: A special symbol is defined here to be any character not-[MAKEINDEX], Up: MAKEINDEX, Next: Entries such as-[MAKEINDEX]
SPECIAL EFFECTS
File: makeindex, Node: Entries such as-[MAKEINDEX], Previous: SPECIAL EFFECTS-[MAKEINDEX], Up: MAKEINDEX, Next: It is possible to make an item appear in a designated form-[MAKEINDEX]
Entries such as
\indexentry{alpha}{1}
\indexentry{alpha!beta}{3}
\indexentry{alpha!beta!gamma}{10}
in the input file will be converted to
\item alpha, 1
\subitem beta, 3
\subsubitem gamma, 10
in the output index file. Notice that the level symbol
(`!') is used above to delimit hierarchical levels.
File: makeindex, Node: It is possible to make an item appear in a designated form-[MAKEINDEX], Previous: Entries such as-[MAKEINDEX], Up: MAKEINDEX, Next: The item, subitem, and subsubitem fields may have individual-[MAKEINDEX]
It is possible to make an item appear in a designated form
by using the actual (`@') operator. For instance,
\indexentry{alpha@{\it alpha\/}}{1}
will become
\item {\it alpha\/}, 1
after processing. The pattern preceding `@' is used as sort
key, whereas the one following it is written to the output
file. Note that two appearances of the same key, one with
and one without the actual operator, are regarded as dis-
tinct entries.
File: makeindex, Node: The item, subitem, and subsubitem fields may have individual-[MAKEINDEX], Previous: It is possible to make an item appear in a designated form-[MAKEINDEX], Up: MAKEINDEX, Next: This will be converted to-[MAKEINDEX]
The item, subitem, and subsubitem fields may have individual
sort keys:
\indexentry{aa@{\it aa\/}!bb@{\it bb\/}!cc@{\it cc\/}}{1}
File: makeindex, Node: This will be converted to-[MAKEINDEX], Previous: The item, subitem, and subsubitem fields may have individual-[MAKEINDEX], Up: MAKEINDEX, Next: It is possible to encapsulate a page number with a desig--[MAKEINDEX]
This will be converted to
\item {\it aa}, 1
\subitem {\it bb}, 3
\subsubitem {\it cc}, 10
File: makeindex, Node: It is possible to encapsulate a page number with a desig--[MAKEINDEX], Previous: This will be converted to-[MAKEINDEX], Up: MAKEINDEX, Next: The encap operator can also be used to create cross refer--[MAKEINDEX]
It is possible to encapsulate a page number with a desig-
nated command using the encap (`|') operator:
\indexentry{alpha|bold}{1}
will be converted to
\item alpha, \bold{1}
where, with a suitable definition for TeX, \bold{n} will
expand to {\bf n}. In this example, the three output attri-
butes associated with page encapsulation encap_prefix,
encap_infix, and encap_suffix, correspond to backslash, left
brace, and right brace, respectively. This mechanism allows
page numbers to be set in different fonts. For example, the
page where the definition of a keyword appears can be in one
font, the location of a primary example can be in another
font, and other appearances in yet a third font.
File: makeindex, Node: The encap operator can also be used to create cross refer--[MAKEINDEX], Previous: It is possible to encapsulate a page number with a desig--[MAKEINDEX], Up: MAKEINDEX, Next: Note that in a cross reference like this the page number-[MAKEINDEX]
The encap operator can also be used to create cross refer-
ences in the index:
\indexentry{alpha|see{beta}}{1}
will become
\item alpha, \see{beta}{1}
in the output file, where
\see{beta}{1}
will expand to
{\it see\/} beta
File: makeindex, Node: Note that in a cross reference like this the page number-[MAKEINDEX], Previous: The encap operator can also be used to create cross refer--[MAKEINDEX], Up: MAKEINDEX, Next: A pair of encap concatenated with range_open (`|(') and-[MAKEINDEX]
Note that in a cross reference like this the page number
disappears.
File: makeindex, Node: A pair of encap concatenated with range_open (`|(') and-[MAKEINDEX], Previous: Note that in a cross reference like this the page number-[MAKEINDEX], Up: MAKEINDEX, Next: Intermediate pages indexed by the same key will be merged-[MAKEINDEX]
A pair of encap concatenated with range_open (`|(') and
range_close (`|)') creates an explicit page range:
\indexentry{alpha|(}{1}
\indexentry{alpha|)}{5}
will become
\item alpha, 1-5
File: makeindex, Node: Intermediate pages indexed by the same key will be merged-[MAKEINDEX], Previous: A pair of encap concatenated with range_open (`|(') and-[MAKEINDEX], Up: MAKEINDEX, Next: Several potential problems are worth mentioning. First,-[MAKEINDEX]
Intermediate pages indexed by the same key will be merged
into the range implicitly. This is especially useful when
an entire section about a particular subject is to be
indexed, in which case only the range opening and closing
operators need to be inserted at the beginning and end of
the section. Explicit page range formation can also include
an extra command to set the page range in a designated font:
\indexentry{alpha|(bold}{1}
\indexentry{alpha|)}{5}
will become
\item alpha, \bold{1--5}
File: makeindex, Node: Several potential problems are worth mentioning. First,-[MAKEINDEX], Previous: Intermediate pages indexed by the same key will be merged-[MAKEINDEX], Up: MAKEINDEX, Next: Finally, every special symbol mentioned in this section may-[MAKEINDEX]
Several potential problems are worth mentioning. First,
entries like
\indexentry{alpha|(}{1}
\indexentry{alpha|bold}{3}
\indexentry{alpha|)}{5}
will be interpreted as
\item alpha, \bold{3}, 1--5
but with a warning message in the transcript about
encountering an inconsistent page encapsulator. An explicit
range beginning in a Roman page number and ending in Arabic
is also considered an error. In this instance, (if possi-
ble) the range is broken into two subranges, one in Roman
and the other in Arabic. For instance,
\indexentry{alpha|(}{i}
\indexentry{alpha}{iv}
\indexentry{alpha}{3}
\indexentry{alpha|)}{7}
will be turned into
\item alpha, i--iv, 3--7
with a warning message in the transcript file complaining
about an illegal range formation.
File: makeindex, Node: Finally, every special symbol mentioned in this section may-[MAKEINDEX], Previous: Several potential problems are worth mentioning. First,-[MAKEINDEX], Up: MAKEINDEX, Next: From version 2.11 of makeindex, the quote operator may quote-[MAKEINDEX]
Finally, every special symbol mentioned in this section may
be escaped by the quote operator (`"'). Thus
\indexentry{alpha"@beta}{1}
will actually become
\item alpha@beta, 1
as a result of executing makeindex. The quoting power of
quote is eliminated if it is immediately preceded by escape
(`\'). For example,
\indexentry{f\"ur}{1}
becomes
\item f\"ur, 1
which represents an umlaut-accented `u' to the TeX family of
processors.
File: makeindex, Node: From version 2.11 of makeindex, the quote operator may quote-[MAKEINDEX], Previous: Finally, every special symbol mentioned in this section may-[MAKEINDEX], Up: MAKEINDEX, Next: The sorting order is-[MAKEINDEX]
From version 2.11 of makeindex, the quote operator may quote
any character in the range 1 ... 255. Character 0 is
excluded because it is used internally in the makeindex
source code as a string terminator. With this change, sort
keys can be created for all eight-bit characters except 0.
File: makeindex, Node: The sorting order is-[MAKEINDEX], Previous: From version 2.11 of makeindex, the quote operator may quote-[MAKEINDEX], Up: MAKEINDEX, Next: Here is an example showing the indexing of all printable-[MAKEINDEX]
The sorting order is
punctuation characters (in ASCII order),
digits,
control characters (1 ... 31),
space (32),
letters (ignoring case),
characters 127 ... 255.
File: makeindex, Node: Here is an example showing the indexing of all printable-[MAKEINDEX], Previous: The sorting order is-[MAKEINDEX], Up: MAKEINDEX, Next: ASCII characters other than letters and digits, assuming the-[MAKEINDEX]
Here is an example showing the indexing of all printable
File: makeindex, Node: ASCII characters other than letters and digits, assuming the-[MAKEINDEX], Previous: Here is an example showing the indexing of all printable-[MAKEINDEX], Up: MAKEINDEX, Next: Characters in the actual fields following the `@' character-[MAKEINDEX]
ASCII characters other than letters and digits, assuming the
default TeX format. For convenience, the page number refer-
ences are the corresponding ASCII ordinal values.
\indexentry{" @" (space)}{32}
\indexentry{"!@"! (exclamation point)}{33}
\indexentry{""@"" (quotation mark)}{34}
\indexentry{"#@"\# (sharp sign)}{35}
\indexentry{"$@"\$ (dollar sign)}{36}
\indexentry{"%@"\% (percent sign)}{37}
\indexentry{"&@"\& (ampersand)}{38}
\indexentry{"@"$>$ (right angle bracket)}{62}
\indexentry{"?@"? (query)}{63}
\indexentry{"@@"@ (at sign)}{64}
\indexentry{"[@"[ (left square bracket)}{91}
\indexentry{"\@"\verb=\= (backslash)}{92}
\indexentry{"]@"] (right square bracket)}{93}
\indexentry{"^@"\verb=^= (caret)}{94}
\indexentry{"_@"\verb=_= (underscore)}{95}
\indexentry{"`@"\verb=~= (grave accent)}{96}
\indexentry{"{@"\"{ (left brace)}{123}
\indexentry{"|@"\verb="|= (vertical bar)}{124}
\indexentry{"}@"\"} (right brace)}{125}
\indexentry{"~@"\verb=~= (tilde)}{126}
File: makeindex, Node: Characters in the actual fields following the `@' character-[MAKEINDEX], Previous: ASCII characters other than letters and digits, assuming the-[MAKEINDEX], Up: MAKEINDEX, Next: FILES-[MAKEINDEX]
Characters in the actual fields following the `@' character
which have special significance to TeX must be represented
as control sequences, or as math mode characters. Note par-
ticularly how the entries for the at sign, left and right
braces, and the vertical bar, are coded. The index file
output by makeindex for this example looks like this:
\begin{theindex}
\item ! (exclamation point), 33
\item " (quotation mark), 34
\item \# (sharp sign), 35
\item \$ (dollar sign), 36
\item \% (percent sign), 37
\item \& (ampersand), 38
\item $$ (right angle bracket), 62
\item ? (query), 63
\item @ (at sign), 64
\item [ (left square bracket), 91
\item \verb=\= (backslash), 92
\item ] (right square bracket), 93
\item \verb=^= (caret), 94
\item \verb=_= (underscore), 95
\item \verb=~= (grave accent), 96
\item \{ (left brace), 123
\item \verb=|= (vertical bar), 124
\item \} (right brace), 125
\item \verb=~= (tilde), 126
\indexspace
\item (space), 32
\end{theindex}
File: makeindex, Node: FILES-[MAKEINDEX], Previous: Characters in the actual fields following the `@' character-[MAKEINDEX], Up: MAKEINDEX, Next: SEE ALSO-[MAKEINDEX]
FILES
/usr/local/bin/makeindex
executable file
/usr/local/lib/tex/macros/idxmac-amstex.tex
TeX macro file used by makeindex
/usr/local/lib/tex/macros/idxmac.tex
TeX macro file used by makeindex
/usr/local/lib/tex/macros/makeidx.doc
TeX macro file used by makeindex
/usr/local/lib/tex/macros/makeidx.sty
TeX macro file used by makeindex
File: makeindex, Node: SEE ALSO-[MAKEINDEX], Previous: FILES-[MAKEINDEX], Up: MAKEINDEX, Next: UCSF Enhanced troff/TRANSCRIPT - An Overview, R. P. C. Rodg--[MAKEINDEX]
SEE ALSO
ditroff(1L), latex(1L), make.index (1L), qsort(3), tex(1L),
troff(1L)
File: makeindex, Node: UCSF Enhanced troff/TRANSCRIPT - An Overview, R. P. C. Rodg--[MAKEINDEX], Previous: SEE ALSO-[MAKEINDEX], Up: MAKEINDEX, Next: School of Pharmacy, San Francisco, 1990.-[MAKEINDEX]
UCSF Enhanced troff/TRANSCRIPT - An Overview, R. P. C. Rodg-
ers and Conrad Huang, LSMB Technical Report 90-2, UCSF
File: makeindex, Node: School of Pharmacy, San Francisco, 1990.-[MAKEINDEX], Previous: UCSF Enhanced troff/TRANSCRIPT - An Overview, R. P. C. Rodg--[MAKEINDEX], Up: MAKEINDEX, Next: Index Preparation and Processing, Pehong Chen and Michael A.-[MAKEINDEX]
School of Pharmacy, San Francisco, 1990.
File: makeindex, Node: Index Preparation and Processing, Pehong Chen and Michael A.-[MAKEINDEX], Previous: School of Pharmacy, San Francisco, 1990.-[MAKEINDEX], Up: MAKEINDEX, Next: Harrison, Software-[MAKEINDEX]
Index Preparation and Processing, Pehong Chen and Michael A.
File: makeindex, Node: Harrison, Software-[MAKEINDEX], Previous: Index Preparation and Processing, Pehong Chen and Michael A.-[MAKEINDEX], Up: MAKEINDEX, Next: September 1988.-[MAKEINDEX]
Harrison, Software: Practice and Experience, 19(9), 897915,
File: makeindex, Node: September 1988.-[MAKEINDEX], Previous: Harrison, Software-[MAKEINDEX], Up: MAKEINDEX, Next: Automating Index Preparation, Pehong Chen and Michael A.-[MAKEINDEX]
September 1988.
File: makeindex, Node: Automating Index Preparation, Pehong Chen and Michael A.-[MAKEINDEX], Previous: September 1988.-[MAKEINDEX], Up: MAKEINDEX, Next: Harrison. Technical Report 87/347, Computer Science Divi--[MAKEINDEX]
Automating Index Preparation, Pehong Chen and Michael A.
File: makeindex, Node: Harrison. Technical Report 87/347, Computer Science Divi--[MAKEINDEX], Previous: Automating Index Preparation, Pehong Chen and Michael A.-[MAKEINDEX], Up: MAKEINDEX, Next: MakeIndex-[MAKEINDEX]
Harrison. Technical Report 87/347, Computer Science Divi-
sion, University of California, Berkeley, 1987 (a LaTeX
document supplied with makeindex).
File: makeindex, Node: MakeIndex-[MAKEINDEX], Previous: Harrison. Technical Report 87/347, Computer Science Divi--[MAKEINDEX], Up: MAKEINDEX, Next: February 1987 (a LaTeX document supplied with makeindex).-[MAKEINDEX]
MakeIndex: An Index Processor for LaTeX, Leslie Lamport,
File: makeindex, Node: February 1987 (a LaTeX document supplied with makeindex).-[MAKEINDEX], Previous: MakeIndex-[MAKEINDEX], Up: MAKEINDEX, Next: Tools for Printing Indices, Jon L. Bentley and Brian W. Ker--[MAKEINDEX]
February 1987 (a LaTeX document supplied with makeindex).
File: makeindex, Node: Tools for Printing Indices, Jon L. Bentley and Brian W. Ker--[MAKEINDEX], Previous: February 1987 (a LaTeX document supplied with makeindex).-[MAKEINDEX], Up: MAKEINDEX, Next: Computing Science Technical Report No. 128, AT&T Bell-[MAKEINDEX]
Tools for Printing Indices, Jon L. Bentley and Brian W. Ker-
nighan, Electronic Publishing - Origination, Dissemination,
and Design, 1(1), 318, June 1988 (also available as:
File: makeindex, Node: Computing Science Technical Report No. 128, AT&T Bell-[MAKEINDEX], Previous: Tools for Printing Indices, Jon L. Bentley and Brian W. Ker--[MAKEINDEX], Up: MAKEINDEX, Next: Laboratories, Murray Hill, NJ 07974, 1986).-[MAKEINDEX]
Computing Science Technical Report No. 128, AT&T Bell
File: makeindex, Node: Laboratories, Murray Hill, NJ 07974, 1986).-[MAKEINDEX], Previous: Computing Science Technical Report No. 128, AT&T Bell-[MAKEINDEX], Up: MAKEINDEX, Next: AUTHOR-[MAKEINDEX]
Laboratories, Murray Hill, NJ 07974, 1986).
File: makeindex, Node: AUTHOR-[MAKEINDEX], Previous: Laboratories, Murray Hill, NJ 07974, 1986).-[MAKEINDEX], Up: MAKEINDEX, Next: Pehong Chen, Chen & Harrison International Systems, Inc.-[MAKEINDEX]
AUTHOR
File: makeindex, Node: Pehong Chen, Chen & Harrison International Systems, Inc.-[MAKEINDEX], Previous: AUTHOR-[MAKEINDEX], Up: MAKEINDEX, Next: Palo Alto, California, USA .-[MAKEINDEX]
Pehong Chen, Chen & Harrison International Systems, Inc.
File: makeindex, Node: Palo Alto, California, USA .-[MAKEINDEX], Previous: Pehong Chen, Chen & Harrison International Systems, Inc.-[MAKEINDEX], Up: MAKEINDEX, Next: Manual page extensively revised and corrected, and troff(1)-[MAKEINDEX]
Palo Alto, California, USA .
File: makeindex, Node: Manual page extensively revised and corrected, and troff(1)-[MAKEINDEX], Previous: Palo Alto, California, USA .-[MAKEINDEX], Up: MAKEINDEX, Next: ACKNOWLEDGMENTS-[MAKEINDEX]
Manual page extensively revised and corrected, and troff(1)
examples created by Rick P. C. Rodgers, UCSF School of Phar-
macy .
File: makeindex, Node: ACKNOWLEDGMENTS-[MAKEINDEX], Previous: Manual page extensively revised and corrected, and troff(1)-[MAKEINDEX], Up: MAKEINDEX, Next: Leslie Lamport contributed significantly to the design.-[MAKEINDEX]
ACKNOWLEDGMENTS
File: makeindex, Node: Leslie Lamport contributed significantly to the design.-[MAKEINDEX], Previous: ACKNOWLEDGMENTS-[MAKEINDEX], Up: MAKEINDEX, Next: Michael Harrison provided valuable comments and suggestions.-[MAKEINDEX]
Leslie Lamport contributed significantly to the design.
File: makeindex, Node: Michael Harrison provided valuable comments and suggestions.-[MAKEINDEX], Previous: Leslie Lamport contributed significantly to the design.-[MAKEINDEX], Up: MAKEINDEX, Next: Nelson Beebe improved on the portable version, and maintains-[MAKEINDEX]
Michael Harrison provided valuable comments and suggestions.
File: makeindex, Node: Nelson Beebe improved on the portable version, and maintains-[MAKEINDEX], Previous: Michael Harrison provided valuable comments and suggestions.-[MAKEINDEX], Up: MAKEINDEX, Next: Brosig contributed to the German word ordering. The modifi--[MAKEINDEX]
Nelson Beebe improved on the portable version, and maintains
the source distribution for the TeX Users Group. Andreas
File: makeindex, Node: Brosig contributed to the German word ordering. The modifi--[MAKEINDEX], Previous: Nelson Beebe improved on the portable version, and maintains-[MAKEINDEX], Up: MAKEINDEX, Next: TRIB files in the makeindex source distribution record other-[MAKEINDEX]
Brosig contributed to the German word ordering. The modifi-
cation to the -ms macros was derived from a method proposed
by Ravi Sethi of AT&T Bell Laboratories. The LOG and CON-
File: makeindex, Node: TRIB files in the makeindex source distribution record other-[MAKEINDEX], Previous: Brosig contributed to the German word ordering. The modifi--[MAKEINDEX], Up: MAKEINDEX, Next: MAKEINDEX
TRIB files in the makeindex source distribution record other
contributions.
Tag table:
File: makeindex, Node: Top210
File: makeindex, Node: MAKEINDEX319
File: makeindex, Node: NAME-[MAKEINDEX]5198
File: makeindex, Node: SYNOPSIS-[MAKEINDEX]5388
File: makeindex, Node: DESCRIPTION-[MAKEINDEX]5625
File: makeindex, Node: The program makeindex is a general purpose hierarchical-[MAKEINDEX]5863
File: makeindex, Node: Kernighan, which is specific to troff(1), generates non--[MAKEINDEX]6773
File: makeindex, Node: The formats of the input and output files are specified in a-[MAKEINDEX]7285
File: makeindex, Node: Unless specified explicitly, the base name of the first-[MAKEINDEX]7711
File: makeindex, Node: For important notes on how to select index keywords, see the-[MAKEINDEX]8348
File: makeindex, Node: OPTIONS-[MAKEINDEX]8806
File: makeindex, Node: STYLE FILE-[MAKEINDEX]12379
File: makeindex, Node: The style file informs makeindex about the format of the-[MAKEINDEX]12615
File: makeindex, Node: The style file contains a list of -[MAKEINDEX]13090
File: makeindex, Node: Pairs do not have to appear in any particular order. A line-[MAKEINDEX]13491
File: makeindex, Node: A literal backslash or quote must be escaped (by a-[MAKEINDEX]14140
File: makeindex, Node: INPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]]14815
File: makeindex, Node: OUTPUT STYLE SPECIFIERS-[A literal backslash or quote must be escaped (by a-[MAKEINDEX]]17463
File: makeindex, Node: EXAMPLES-[MAKEINDEX]23832
File: makeindex, Node: TeX EXAMPLE-[EXAMPLES-[MAKEINDEX]]24130
File: makeindex, Node: The following example shows a style file called book.ist,-[MAKEINDEX]24327
File: makeindex, Node: Assuming that a particular book style requires the index (as-[MAKEINDEX]24905
File: makeindex, Node: Here a non-default output file name is used to avoid-[MAKEINDEX]25469
File: makeindex, Node: TROFF EXAMPLE-[Here a non-default output file name is used to avoid-[MAKEINDEX]]26074
File: makeindex, Node: A sample control file for creating an index, which we will-[MAKEINDEX]26429
File: makeindex, Node: The local macro package may require modification, as in this-[MAKEINDEX]27700
File: makeindex, Node: Note that index entries are indicated by the .IX macro,-[MAKEINDEX]28967
File: makeindex, Node: CREATING THE INDEX FILE IN THE BOURNE SHELL-[Note that index entries are indicated by the .IX macro,-[MAKEINDEX]]29585
File: makeindex, Node: To create an input file for makeindex, in the Bourne shell-[MAKEINDEX]29970
File: makeindex, Node: Some sites will require ditroff instead of psroff. To-[MAKEINDEX]30430
File: makeindex, Node: CREATING THE INDEX FILE USING UCSF ENHANCED TROFF/TRANSCRIPT-[Some sites will require ditroff instead of psroff. To-[MAKEINDEX]]31083
File: makeindex, Node: With UCSF Enhanced troff/TRANSCRIPT, the -I option of-[MAKEINDEX]31486
File: makeindex, Node: If it is wished to suppress the formatter output-[MAKEINDEX]31920
File: makeindex, Node: COMPLETING THE INDEX-[If it is wished to suppress the formatter output-[MAKEINDEX]]32422
File: makeindex, Node: Any of the above procedures leaves the input for makeindex-[MAKEINDEX]32748
File: makeindex, Node: This leaves troff(1)-ready output in the file sample.ind.-[MAKEINDEX]33167
File: makeindex, Node: ORDERING-[MAKEINDEX]33400
File: makeindex, Node: By default, makeindex assumes word ordering; if the -l-[MAKEINDEX]33684
File: makeindex, Node: Numbers are always sorted in numeric order. For instance,-[MAKEINDEX]34335
File: makeindex, Node: Letters are first sorted without regard to case; when words-[MAKEINDEX]34725
File: makeindex, Node: A special symbol is defined here to be any character not-[MAKEINDEX]35139
File: makeindex, Node: SPECIAL EFFECTS-[MAKEINDEX]35719
File: makeindex, Node: Entries such as-[MAKEINDEX]35923
File: makeindex, Node: It is possible to make an item appear in a designated form-[MAKEINDEX]36514
File: makeindex, Node: The item, subitem, and subsubitem fields may have individual-[MAKEINDEX]37214
File: makeindex, Node: This will be converted to-[MAKEINDEX]37561
File: makeindex, Node: It is possible to encapsulate a page number with a desig--[MAKEINDEX]37958
File: makeindex, Node: The encap operator can also be used to create cross refer--[MAKEINDEX]38943
File: makeindex, Node: Note that in a cross reference like this the page number-[MAKEINDEX]39481
File: makeindex, Node: A pair of encap concatenated with range_open (`|(') and-[MAKEINDEX]39834
File: makeindex, Node: Intermediate pages indexed by the same key will be merged-[MAKEINDEX]40325
File: makeindex, Node: Several potential problems are worth mentioning. First,-[MAKEINDEX]41148
File: makeindex, Node: Finally, every special symbol mentioned in this section may-[MAKEINDEX]42279
File: makeindex, Node: From version 2.11 of makeindex, the quote operator may quote-[MAKEINDEX]43036
File: makeindex, Node: The sorting order is-[MAKEINDEX]43543
File: makeindex, Node: Here is an example showing the indexing of all printable-[MAKEINDEX]44021
File: makeindex, Node: ASCII characters other than letters and digits, assuming the-[MAKEINDEX]44320
File: makeindex, Node: Characters in the actual fields following the `@' character-[MAKEINDEX]45783
File: makeindex, Node: FILES-[MAKEINDEX]47194
File: makeindex, Node: SEE ALSO-[MAKEINDEX]47829
File: makeindex, Node: UCSF Enhanced troff/TRANSCRIPT - An Overview, R. P. C. Rodg--[MAKEINDEX]48135
File: makeindex, Node: School of Pharmacy, San Francisco, 1990.-[MAKEINDEX]48444
File: makeindex, Node: Index Preparation and Processing, Pehong Chen and Michael A.-[MAKEINDEX]48764
File: makeindex, Node: Harrison, Software-[MAKEINDEX]49001
File: makeindex, Node: September 1988.-[MAKEINDEX]49250
File: makeindex, Node: Automating Index Preparation, Pehong Chen and Michael A.-[MAKEINDEX]49504
File: makeindex, Node: Harrison. Technical Report 87/347, Computer Science Divi--[MAKEINDEX]49798
File: makeindex, Node: MakeIndex-[MAKEINDEX]50134
File: makeindex, Node: February 1987 (a LaTeX document supplied with makeindex).-[MAKEINDEX]50467
File: makeindex, Node: Tools for Printing Indices, Jon L. Bentley and Brian W. Ker--[MAKEINDEX]50753
File: makeindex, Node: Computing Science Technical Report No. 128, AT&T Bell-[MAKEINDEX]51214
File: makeindex, Node: Laboratories, Murray Hill, NJ 07974, 1986).-[MAKEINDEX]51519
File: makeindex, Node: AUTHOR-[MAKEINDEX]51734
File: makeindex, Node: Pehong Chen, Chen & Harrison International Systems, Inc.-[MAKEINDEX]52002
File: makeindex, Node: Palo Alto, California, USA .-[MAKEINDEX]52275
File: makeindex, Node: Manual page extensively revised and corrected, and troff(1)-[MAKEINDEX]52608
File: makeindex, Node: ACKNOWLEDGMENTS-[MAKEINDEX]52944
File: makeindex, Node: Leslie Lamport contributed significantly to the design.-[MAKEINDEX]53238
File: makeindex, Node: Michael Harrison provided valuable comments and suggestions.-[MAKEINDEX]53532
File: makeindex, Node: Nelson Beebe improved on the portable version, and maintains-[MAKEINDEX]53871
File: makeindex, Node: Brosig contributed to the German word ordering. The modifi--[MAKEINDEX]54272
File: makeindex, Node: TRIB files in the makeindex source distribution record other-[MAKEINDEX]54735
End tag table