NAME

ptx − permuted index

SYNOPSIS

ptx [ options ] [ input [ output ] ]

DESCRIPTION

Ptx generates a permuted index to file input on file output (by default, standard input and output).  It has three phases: the first does the permutation, generating one line for each keyword in an input line.  Ptx rotates the keyword to the front.  Then ptx sorts the permuted file.  Finally, ptx rotates the sorted lines so the keyword comes at the middle of the page. 

Ptx produces output in the form:

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

where .xx may be an nroff or troff(1) macro for user-defined formatting.  The before keyword and keyword and after fields incorporate as much of the line as will fit around the keyword when it is printed at the middle of the page.  Tail and head, at least one of which is an empty string "", are wrapped-around pieces small enough to fit in the unused space at the opposite end of the line.  When original text must be discarded, ‘/’ marks the spot. 

The index for this manual was generated using ptx. 

OPTIONS

−b break
Uses the characters in the break file to separate words.  In any case, tab, newline, and space characters are always used as break characters. 

−f Folds upper and lower case letters for sorting. 

−g n Uses the next argument, n, as the number of characters to allow for each gap among the four parts of the line as finally printed.  The default gap is 3 characters. 

−i ignore
Does not use as keywords any words given in the ignore file.  If the −i and −o options are missing, use /usr/lib/eign as the ignore file. 

−o only
Uses as keywords only the words given in the only file. 

−r Takes 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.  Attaches that identifier as a 5th field on each output line. 

−t Prepares the output for the phototypesetter; the default line length is 100 characters. 

−w n Uses the next argument, n, as the width of the output line.  The default line length is 72 characters. 

FILES

/usr/bin/sort
/usr/lib/eign

BUGS

Line length counts do make allowance for overstriking or proportional spacing. 
 

INTEGRATED SOLUTIONS 4.3 BSD  —  April 29, 1985