# ptx(1) - man - phpMan

[PTX(1)](https://www.chedong.com/phpMan.php/man/PTX/1/markdown)                                      User Commands                                     [PTX(1)](https://www.chedong.com/phpMan.php/man/PTX/1/markdown)



## 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
              use STRING for flagging line truncations.  The default is '/'

### -M --macro-name
              macro name to use instead of 'xx'

### -O --format
              generate output as roff directives

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

### -S --sentence-regexp
              for end of lines or end of sentences

### -T --format
              generate output as TeX directives

### -W --word-regexp
              use REGEXP to match each keyword

### -b --break-file
              word break characters in this FILE

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

### -g --gap-size
              gap size in columns between output fields

### -i --ignore-file
              read ignore word list from FILE

### -o --only-file
              read only word list from this FILE

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

### -t --typeset-mode

### -w --width
              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: <<https://www.gnu.org/software/coreutils/>>
       Report any translation bugs to <<https://translationproject.org/team/>>

## COPYRIGHT
       Copyright  ©  2020 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later
       <<https://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 <<https://www.gnu.org/software/coreutils/ptx>>
       or available locally via: info '(coreutils) ptx invocation'



GNU coreutils 8.32                          January 2026                                      [PTX(1)](https://www.chedong.com/phpMan.php/man/PTX/1/markdown)