GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PTX (1)

NAME

ptx - permuted index

CONTENTS

Synopsis
Description
Environment Variables
Files
Notes

SYNOPSIS

ptx [-ftr] [-w n] [-g n] [-o only] [-i ignore] [-b break] [input [output]]

DESCRIPTION

ptx generates a permuted index to file input on file output (standard input and output default). It has three phases: the first does the permutation, generating one line for each keyword in an input line. The keyword is rotated to the front. The permuted file is then sorted. Finally, the sorted lines are rotated 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. Once choice for this macro is supplied in the '-mptx' macro package. 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 following options can be applied:
-f Fold upper and lower case letters for sorting.
-t Prepare the output for the phototypesetter, i.e. set the default line length to 100 characters.
-w n Use the next argument, n, as the width of the output line. The default line length is 72 characters.
-g n Use 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.
-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 missing, use /usr/ucblib/eign as the ignore file.
-b break
  Use the characters in the break file to separate words. In any case, tab, newline, and space characters are 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 5th field on each output line.

ENVIRONMENT VARIABLES

LANG, LC_ALL See locale(7).
LC_COLLATE Determines the sort order.
LC_CTYPE Determines the mapping of bytes to characters.

FILES

/usr/5bin/sort
/usr/ucblib/eign
/usr/ucblib/doctools/tmac/ptx
 

NOTES

Line length counts do not account for overstriking or proportional spacing.
Search for    or go to Top of page |  Section 1 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.