Unix Man (Справочное руководство)


PTX(1)


PTX(1)

НАЗВАНИЕ


ptx - упорядоченный предметный указатель

СИНТАКСИС

ptx [опции] [ввод [вывод]]

ОПИСАНИЕ


Команда ptx создает файл вывод, который можно обработать text formatter'ом и получить упорядоченный предметный указатель для файла ввод (по умолчанию - стандартный вывод и стандартный ввод). Выполнение делится на три фазы: на первой происходит упорядочение, когда для каждого ключевого слова на входной строке генерируется одна строка. Ключевые слова циклическим сдвигом ставятся в начало строк. Затем строки файла упорядочиваются. Наконец, в упорядоченных строках опять делается циклический сдвиг, так что ключевые слова оказываются на прежних местах в строке. Вывод ptx имеет вид:

.xx "хвост" "до ключа" "ключ и за ним" "голова"

где предполагается, что .xx - это макро nroff или troff(1), обеспечиваемая пользователем либо пакетом ??????? макро mptx(5). Поля до ключа и ключ и за ним содержат ??? mptx(5) - сс максимально возможную при печати часть строки вокруг ключевого слова. Хвост и голова, по крайней мере одна из которых - пустая строка, являются окружающими частями строки, достаточно малыми чтобы поместиться в свободном месте строки.

Можно использовать следующие опции:

-f -t -w n -g n -o only-i ignore-b break-r
Не различать большие и маленькие буквы при упорядочивании строк.
Подготовить вывод для фотопечати.
Использовать следующий аргумент, n, как длину строки в выводе. По умолчанию в строке 72 символа для nroff и 100 для troff.
Использовать следующий аргумент, n, как длину промежутка, который ptx оставляет между четырьмя частями строки при ее окончательном выводе. По умолчанию промежуток - 3 пробела. Реально не 3, а 1, а опция работает очень странно.

Использовать в качестве ключевых только слова из файла с именем only.

Не использовать в качестве ключевых слова, находящиеся в файле с именем ignore. Если опции -i и -o опущены, в качестве файла ignore используется файл /usr/lib/ejgn.

Использовать символы из файла с именем break в качестве разделителей. Символ табуляции, перевод строки и пробелы используются в качестве разделителей всегда.

Использовать в качестве указателя ссылки (например, ссылка на страницу или главу), начальные непробелы на каждой строке, отделенные от текста строки. Выводить указатель ссылки в 5-е поле выводимой строки

Указатель для этого руководства был изготовлен с помощью ptx.

ФАЙЛЫ

/bin/sort /usr/lib/eign /usr/lib/tmac/tmac.ptx

СМ. ТАКЖЕ


?????? , troff(1), mm(5), mptx(5) в руководстве UNIX ????? System V DOCUMENTER'S WORKBENCH Software, Introduction and Reference Manual (307-150, Issue 2).

ПРЕДОСТЕРЕЖЕНИЯ


В исходной версии системы UNIX 5.3 программа ptx отсутствовала. При обработке текста важно, чтобы в качестве разделителей были указаны такие знаки как точка, запятая и т.д. По-видимому, при обработке текстов опция -r является практически обязательной.

СЮРПРИЗЫ


Счетчики длины строк не учитывают наложения или пропорционального разграничения. Строки, содержащие тильды (~), портятся, так как этот символ является для ptx служебным. Опция -g не выдерживает точно ширину строки. Опция -w работает очень странно.




Начало  Назад  Вперед



Книжный магазин