Иван Георгиевич Титаренко - Руководство пользователя GNU troff

«grn»), обработки библиографии («refer»), вывода формул химических структур («chem»). Ассоциированная программа, полезная при работе с препроцессорами, называется «soelim».

В качестве дополнительного пакета имеется бесплатная реализация препроцессора создания графиков «grap».

Уникальным для «groff» является препроцессор «preconv», он позволяет обрабатывать документы в различных входных кодировках.

Существуют и другие препроцессоры, но, к сожалению, бесплатных реализаций нет.

Groff создает независимый от устройств код, он может быть передан в постпроцессор для работы с конкретным устройством. В настоящее время groff поддерживает постпроцессоры для устройств POSTSCRIPT, символьных терминалов, оконной среды X Windows (для предварительного просмотра), подготовки файлов формата TeX DVI, также обеспечивает поддержку принтеров HP LaserJet 4 и Canon LBP (CAPSL), вывод HTML, XHTML и PDF.

О документе. Большая часть руководства взята из существующих документов, в первую очередь это страницы руководства groff Джеймса Кларка и замечания Эрика Оллмана к пакету макросов «me». Раздел пакета макросов «man» частично основан на справочной странице Сьюзэн Клейнман («groff_man»), написанной для дистрибутива Debian GNU/Linux. Ларри Коллар предоставил материал для пакета макросов «ms».

Командная строка

В этом разделе основное внимание уделяется тому, как вызвать внешний интерфейс groff. Интерфейс командной строки управляет построением конвейера между препроцессорами, gtroff и постпроцессорами.

Программы GNU традиционно получают префикс «g», чтобы отличить их от оригинальных программ. Например, «geqn» — это «eqn» версии GNU. В операционных системах GNU/Linux или Hurd, которые не содержат проприетарных версий troff, а также в MS‐DOS/MS‐Windows, префикс опущен, так как GNU troff является единственным вариантом troff.

В этом документе мы пишем gtroff, если подразумеваем программу GNU troff. Все остальные реализации называются troff AT&T.

Опции командной строки

Команда «groff» обычно запускает программу «gtroff» и постпроцессор, соответствующий выбранному устройству. Устройством по умолчанию считается «ps».

Многие аргументы «groff» также передаются «gtroff». Аргументы для пре‐ или постпроцессоров можно найти в вызовах gpic, geqn, gtbl, ggrn, grefer, gchem, gsoelim, preconv, grotty, grops, gropdf, grohtml, grodvi, grolj4, grolbp и gxditview.

Формат командной строки для «groff» следующий.

groff [ ‐abceghijklpstvzCEGNRSUVXZ ] [ ‐d«cs» ] [ ‐D«arg» ]

[ ‐f«fam» ] [ ‐F«dir» ] [ ‐I«dir» ] [ ‐K«arg» ] [ ‐L«arg» ]

[ ‐m«name» ] [ ‐M«dir» ] [ ‐n«num» ] [ ‐o«list» ] [ ‐P«arg» ]

[ ‐r«cn» ] [ ‐T«dev» ] [ ‐w«name» ] [ ‐W«name» ] [ «files»... ]

Однако для работы с командной строкой «gtroff» ввод изменен.

gtroff [ ‐abcivzCERU ] [ ‐d«cs» ] [ ‐f«fam» ] [ ‐F«dir» ]

[ ‐m«name» ] [ ‐M«dir» ] [ ‐n«num» ] [ ‐o«list» ] [ ‐r«cn» ]

[ ‐T«name» ] [ ‐w«name» ] [ ‐W«name» ] [ «files» ... ]

Впрочем, многие опции groff фактически передаются gtroff без модификаций.

Опции без аргумента могут быть сгруппированы за символом «‐». Символ «‐» предполагает стандартный ввод. Между опцией и параметрром может быть пробел.

Утилиту «grog» допускается применять для угадывания правильной команды groff.

Параметры командной строки даются ниже.

• «‐a»

Опция создает аппроксимацию ASCII для вывода в терминал. Доступный только для чтения регистр «.A» принимает значение 1.

:: groff ‐a ‐man ‐Tdvi troff.man | less

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

• «‐b»

Трассировка с предупреждением или сообщением об ошибке. Обратная трассировка помогает отследить причину ошибки. Номера строк, указанные в трассировке, не всегда правильно определяются: иногда gtroff ошибается с запросами «as» или «am» при подсчете строк.

• «‐c»

Подавление цветного вывода.

• «‐C»

Включает режим совместимости различных версий troff.

• «‐d c s»

• «‐d name=s»

Опции определяют «c» или «name» как строку «s». В данном случае «c» однобуквенное имя, «name» может быть произвольной длины. Все определения строк происходят до загрузки любого файла макроса, включая стартовый файл.

• «‐D arg»

Установит кодировку ввода «preconv» на «arg». По умолчанию препроцессор включается опцией «‐k».

• «‐e»

Предварительная обработка с помощью «geqn».

• «‐E»

Запрещает вывод --">