PTX(1)                   DOMAIN/IX SYS5                    PTX(1)



NAME
     ptx - permuted index

USAGE
     ptx [ options ] [ input [ output ] ]

DESCRIPTION
     Ptx generates the file output that can be processed with a
     text formatter to produce a permuted index of file input
     (standard input and output default).  First, it does the
     permutation, generating one line for each keyword in an
     input line; then it rotates the keyword to the front and
     sorts the permuted file; and finally, it rotates the sorted
     lines so the keyword comes at the middle of each line.

     Ptx output appears in the following form:

           .xx "tail" "before keyword" "keyword and after" "head"

     The .xx shown above is assumed to be an nroff(1) or troff(1)
     macro that you provide.  The before keyword and keyword and
     after fields incorporate as much of the line as will fit
     around the keyword when it is printed.  Tail and head, at
     least one of which is always the empty string, are wrapped-
     around pieces small enough to fit in the unused space at the
     opposite end of the line.

OPTIONS
     -f        Fold upper- and lowercase letters for sorting.

     -t        Prepare the output for the phototypesetter.

     -w n      Use n as the length of the output line.  The
               default line length is 72 characters for nroff(1)
               and 100 for troff(1).

     -g n      Use n as the number of characters to reserve for
               each gap among the four parts of the line as
               finally printed.  The default gap is three charac-
               ters.

     -o only   Use as keywords only the words given in the only
               file.

     -i ignore Do not use as keywords any words given in the
               ignore file.  If the -i and -o options are miss-
               ing, use /usr/lib/eign as the ignore file.

     -b break  Use the characters in the break file to separate
               words.  Tab, newline, and space characters are



Printed 12/4/86                                             PTX-1

PTX(1)                   DOMAIN/IX SYS5                    PTX(1)



               always used as break characters.

     -r        Take any leading nonblank characters of each input
               line to be a reference identifier (as to a page or
               chapter), separate from the text of the line.
               Attach that identifier as a fifth field on each
               output line.

CAUTIONS
     Line length counts do not account for overstriking or pro-
     portional spacing.

     Because ptx uses tildes internally, lines containing them do
     not print correctly.

FILES
     /bin/sort
     /usr/lib/eign

RELATED INFORMATION
     nroff(1), troff(1), mm(5).
































PTX-2                                             Printed 12/4/86