Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ ptx(1) — sys5 — Apollo Domain/OS SR10.3.5

Media Vault

Software Library

Restoration Projects

Artifacts Sought

PTX(1)                               SysV                               PTX(1)



NAME
     ptx - permuted index

SYNOPSIS
     ptx [ options ] [ input [ output ] ]

DESCRIPTION
     The ptx command generates the file output that can be processed with a
     text formatter to produce a permuted index of file input (standard input
     and output default).  First, it does the permutation, generating one line
     for each keyword in an input line; then it rotates the keyword to the
     front and sorts the permuted file; and finally, it rotates the sorted
     lines so the keyword comes at the middle of each line.

     The output from ptx appears in the following form:

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

     The .xx shown above is assumed to be an nroff(1) or troff(1) macro that
     you provide.  The before keyword and keyword and after fields incorporate
     as much of the line as will fit around the keyword when it is printed.
     Tail and head, at least one of which is always the empty string, are
     wrapped-around pieces small enough to fit in the unused space at the
     opposite end of the line.

OPTIONS
     -f        Fold upper- and lowercase letters for sorting.

     -t        Prepare the output for the phototypesetter.

     -w n      Use n as the length of the output line.  The default line
               length is 72 characters for nroff(1) and 100 for troff(1).

     -g n      Use n as the number of characters to reserve for each gap among
               the four parts of the line as finally printed.  The default gap
               is three 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/lib/eign as the
               ignore file.

     -b break  Use the characters in the break file to separate words.  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 fifth field
               on each output line.

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

     Because ptx uses tildes internally, lines containing them do not print
     correctly.

FILES
     /bin/sort
     /usr/lib/eign

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026