ptx(1) [ultrix man page]

ptx(1)							      General Commands Manual							    ptx(1)

Name
       ptx - create permuted index

Syntax
       ptx [option...] [input[output]]

Description
       The  command  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.	The command produces output in the
       form:

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

       where .xx may be an or macro for user-defined formatting.  The before keyword and keyword and after fields incorporate as much of the  line
       as  fits  around  the keyword when it is printed at the middle of the page.  The and commands, 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.

Options
       The following options can be applied:

       -b break 	   Use	the  characters in the break file as separators.  In any case, tab, new line, and space characters are always used
			   as break characters.

       -f		   Folds upper and lower case letters for sorting.

       -g n		   Uses specified number as interfield gap.  The default gap is 3 characters.

       -i ignore	   Do 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		   Use words listed only in the only file.

       -r		   Uses leading nonblanks as reference identifiers.  Attach 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		   Use the next argument, n, as the width of the output line.  The default line length is 72 characters.

Restrictions
       Line length counts do not account for overstriking or proportional spacing.

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

																	    ptx(1)

PTX(1)								   User Commands							    PTX(1)

NAME

       ptx - produce a permuted index of file contents

SYNOPSIS

       ptx [OPTION]... [INPUT]...   (without -G)
       ptx -G [OPTION]... [INPUT [OUTPUT]]

DESCRIPTION

       Output a permuted index, including context, of the words in the input files.

       With no FILE, or when FILE is -, read standard input.

       Mandatory arguments to long options are mandatory for short options too.

       -A, --auto-reference
	      output automatically generated references

       -G, --traditional
	      behave more like System V 'ptx'

       -F, --flag-truncation=STRING
	      use STRING for flagging line truncations.  The default is '/'

       -M, --macro-name=STRING
	      macro name to use instead of 'xx'

       -O, --format=roff
	      generate output as roff directives

       -R, --right-side-refs
	      put references at right, not counted in -w

       -S, --sentence-regexp=REGEXP
	      for end of lines or end of sentences

       -T, --format=tex
	      generate output as TeX directives

       -W, --word-regexp=REGEXP
	      use REGEXP to match each keyword

       -b, --break-file=FILE
	      word break characters in this FILE

       -f, --ignore-case
	      fold lower case to upper case for sorting

       -g, --gap-size=NUMBER
	      gap size in columns between output fields

       -i, --ignore-file=FILE
	      read ignore word list from FILE

       -o, --only-file=FILE
	      read only word list from this FILE

       -r, --references
	      first field of each line is a reference

       -t, --typeset-mode		- not implemented -

       -w, --width=NUMBER
	      output width in columns, reference excluded

       --help display this help and exit

       --version
	      output version information and exit

AUTHOR

       Written by F. Pinard.

REPORTING BUGS

       GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
       Report ptx translation bugs to <http://translationproject.org/team/>

COPYRIGHT

       Copyright (C) 2017 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       Full documentation at: <http://www.gnu.org/software/coreutils/ptx>
       or available locally via: info '(coreutils) ptx invocation'

GNU coreutils 8.28						   January 2018 							    PTX(1)