1 IDXTEX
 IDXTEX is a program to aid in creating an index for a LaTeX document.
 It reads the .IDX file created by LaTeX and writes a .TEX file that
 can be processed by LaTeX.  The syntax of the command is

     IDXTEX  <input>  [<output>]

 <input> is the file containing the index information from LaTeX.  The
 default extension is .IDX.  <output> is the name of the output file
 containing the theindex environment and the \item commands for the
 index.  If it is omitted, it defaults to INDEX.TEX.

 For more information on indexes, see section 4.5 of the LaTeX User's
 Guide & Reference Manual by Leslie Lamport.

2 Creating_an_index
 To create an index, use the following procedure:

 1. Use the \index{...} command in your document for any item you
    want to appear in the index.  See the Index_command subtopic
    for information on what the argument should be.

 2. Add the \makeindex command to the prolog of the document.

 3. Process the document with LaTeX.  This will create the .IDX file.

 4. Run IDXTEX on the .IDX file and create the output file.

 5. Run LaTeX on the document again to process the index.  You can
    \include the file and use \includeonly so you only process the
    index file.

2 Index_command
 The \index command puts its argument and the page number into the
 .IDX file.  IDXTEX supports all three levels of entries in the index:
 \item, \subitem, and \subsubitem.  The keywords for the levels are
 separated by the exclamation mark (!).  You can specify a different
 sort order by putting the sort string in square brackets before the
 topic.  This is used when you want to add formatting commands for
 when you process the index with LaTeX.  If you put an exclamation
 mark at the end, the page number is omitted. This is used for cross
 references.  For example:

     \index{topic!subtopic!subsubtopic}
     \index{[log]$\log$}
     \index{[topic!subtopic]\bf topic!subtopic}
     \index{topic!see other topic!}

 There should be no extra spaces in the string.  You can put a space
 in the topic, but not on either side of the brackets or exclamation
 marks.  Each keyword in the string has a maximum length of 80 characters.
 The total length of the sort string and the topic string must be less
 than 300 characters.
