Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
PTX(1)			FreeBSD	General	Commands Manual			PTX(1)

     ptx -- permuted index

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

     ptx generates a permuted index to file input on file output (standard in-
     put and output default).  It has three phases: the	first does the permu-
     tation, generating	one line for each keyword in an	input line.  The key-
     word is rotated to	the front.  The	permuted file is then sorted.  Fi-
     nally, 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 op-
     posite 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

     -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

     -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.

     LANG, LC_ALL  See locale(7).

     LC_COLLATE	   Determines the sort order.

     LC_CTYPE	   Determines the mapping of bytes to characters.


     Line length counts	do not account for overstriking	or proportional	spac-

FreeBSD	13.0		       February	2, 2007			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help