masterindex — indexing program for single and multivolume indexing.
masterindex [-master [volume]] [-page] [-screen] [filename..]
masterindex generates a formatted index based on structured index entries output by troff. Unless you redirect output, it comes to the screen.
-m or -master indicates that
you are compiling a multivolume index. The index entries for each
volume should be in a single file and the filenames should be listed
in sequence. If the first file is not the first volume, then specify
the volume number as a separate argument. The volume number is
converted to a roman numeral and prepended to all the page numbers
of entries in that file.
-p or -page produces a
listing of index entries for each page number. It can be used to
proof the entries against hardcopy.
-s or -screen specifies that
the unformatted index will be viewed on the “screen”. The default is
to prepare output that contains troff macros for formatting.
| /work/bin/masterindex |
| /work/bin/page.idx |
| /work/bin/pagenums.idx |
| /work/bin/combine.idx |
| /work/bin/format.idx |
| /work/bin/rotate.idx |
| /work/bin/romanum |
| /work/macros/current/indexmacs |
The new index program is modular, invoking a series of smaller programs. This should allow me to connect different modules to implement new features as well as isolate and fix problems more easily. Index entries should not contain any troff font changes. The program does not handle them. Roman numerals greater than eight will not be sorted properly, thus imposing a limit of an eight-book index. (The sort program will sort the roman numerals 110 in the following order: I, II, III, IV, IX, V, VI, VII, VIII, X.)