|
|
1.1 ! root 1: .\" @(#)ptx.1 6.1 (Berkeley) 4/29/85 ! 2: .\" ! 3: .TH PTX 1 "April 29, 1985" ! 4: .AT 3 ! 5: .SH NAME ! 6: ptx \- permuted index ! 7: .SH SYNOPSIS ! 8: .B ptx ! 9: [ option ] ... ! 10: [ input [ output ] ] ! 11: .SH DESCRIPTION ! 12: .I Ptx ! 13: generates a permuted index to file ! 14: .I input ! 15: on file ! 16: .I output ! 17: (standard input and output default). ! 18: It has three phases: the first does the permutation, generating ! 19: one line for each keyword in an input line. ! 20: The keyword is rotated to the front. ! 21: The permuted file is then ! 22: sorted. ! 23: Finally, the sorted lines are rotated so the keyword ! 24: comes at the middle of the page. ! 25: .I Ptx ! 26: produces output in the form: ! 27: .br ! 28: .IP ! 29: \&.xx "tail" "before keyword" "keyword and after" "head" ! 30: .LP ! 31: where .xx may be an ! 32: .I nroff ! 33: or ! 34: .IR troff (1) ! 35: macro ! 36: for user-defined formatting. ! 37: The ! 38: .I before keyword ! 39: and ! 40: .I keyword and after ! 41: fields incorporate as much of the line as will fit ! 42: around the keyword when it is printed at the middle of the page. ! 43: .I Tail ! 44: and ! 45: .I head, ! 46: at least one of which is an empty string "", ! 47: are wrapped-around pieces small enough to fit ! 48: in the unused space at the opposite end of the line. ! 49: When original text must be discarded, `/' marks the spot. ! 50: .PP ! 51: The following options can be applied: ! 52: .TP ! 53: .BR \-f ! 54: Fold upper and lower case letters for sorting. ! 55: .TP ! 56: .BR \-t ! 57: Prepare the output for the phototypesetter; ! 58: the default line length is 100 characters. ! 59: .TP ! 60: .BI \-w " n" ! 61: Use the next argument, ! 62: .I n, ! 63: as the width of the output line. ! 64: The default line length is 72 characters. ! 65: .TP ! 66: .BI \-g " n" ! 67: Use the next argument, ! 68: .I n, ! 69: as the number of characters to allow for each gap ! 70: among the four parts of the line as finally printed. ! 71: The default gap is 3 characters. ! 72: .TP ! 73: .BR \-o " only" ! 74: Use as keywords only the words given in the \fIonly\fR file. ! 75: .TP ! 76: .BR \-i " ignore" ! 77: Do not use as keywords any words given in the ! 78: .I ! 79: ignore ! 80: file. ! 81: If the \fB\-i\fR and \fB\-o\fR options are missing, use ! 82: .I /usr/lib/eign ! 83: as the ! 84: .I ! 85: ignore ! 86: file. ! 87: .TP ! 88: .BR \-b " break" ! 89: Use the characters in the ! 90: .I ! 91: break ! 92: file to separate words. ! 93: In any case, tab, newline, and space characters are always used as break characters. ! 94: .TP ! 95: .BR \-r ! 96: Take any leading nonblank characters of each input line to ! 97: be a reference identifier (as to a page or chapter) ! 98: separate from the text of the line. ! 99: Attach that identifier as a 5th field on each output line. ! 100: .PP ! 101: The index for this manual was generated using ! 102: .I ptx. ! 103: .SH FILES ! 104: /usr/bin/sort ! 105: .br ! 106: /usr/lib/eign ! 107: .SH BUGS ! 108: Line length counts do not account for overstriking or ! 109: proportional spacing. ! 110: .br
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.