1PTX(1)                      General Commands Manual                     PTX(1)
2
3
4

NAME

6       ptx - permuted index
7

SYNOPSIS

9       ptx [ option ] ...  [ input [ output ] ]
10

DESCRIPTION

12       Ptx  generates  a permuted index to file input on file output (standard
13       input and output default).  It has three phases:  the  first  does  the
14       permutation,  generating  one  line  for each keyword in an input line.
15       The keyword is rotated to the front.  The permuted file is then sorted.
16       Finally,  the sorted lines are rotated so the keyword comes at the mid‐
17       dle of the page.  Ptx produces output in the form:
18
19              .xx "tail" "before keyword" "keyword and after" "head"
20
21       where .xx may be an nroff or troff(1) macro  for  user-defined  format‐
22       ting.   The  before keyword and keyword and after fields incorporate as
23       much of the line as will fit around the keyword when it is  printed  at
24       the  middle  of  the  page.  Tail and head, at least one of which is an
25       empty string "", are wrapped-around pieces small enough to fit  in  the
26       unused  space at the opposite end of the line.  When original text must
27       be discarded, `/' marks the spot.
28
29       The following options can be applied:
30
31       -f     Fold upper and lower case letters for sorting.
32
33       -t     Prepare the output for the  phototypesetter;  the  default  line
34              length is 100 characters.
35
36       -w n   Use  the next argument, n, as the width of the output line.  The
37              default line length is 72 characters.
38
39       -g n   Use the next argument, n, as the number of characters  to  allow
40              for  each  gap  among  the  four  parts  of  the line as finally
41              printed.  The default gap is 3 characters.
42
43       -o only
44              Use as keywords only the words given in the only file.
45
46       -i ignore
47              Do not use as keywords any words given in the ignore  file.   If
48              the  -i  and  -o  options  are missing, use /usr/lib/eign as the
49              ignore file.
50
51       -b break
52              Use the characters in the break file to separate words.  In  any
53              case,  tab,  newline,  and  space  characters are always used as
54              break characters.
55
56       -r     Take any leading nonblank characters of each input line to be  a
57              reference identifier (as to a page or chapter) separate from the
58              text of the line.  Attach that identifier as a 5th field on each
59              output line.
60
61       The index for this manual was generated using ptx.
62

FILES

64       /bin/sort
65       /usr/lib/eign
66

BUGS

68       Line  length  counts  do  not  account for overstriking or proportional
69       spacing.
70
71
72
73                                                                        PTX(1)
Impressum