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

обработка с помощью «gtbl».

Вывод на устройство

В программе под устройствами понимают форматированный определенным образом текст. Например, устройство «ps» создает файл для принтеров формата POSTSCRIPT.

• «‐T dev»

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

В настоящее время доступны следующие устройства вывода.

• «ps»

Устройство для принтеров и программ предварительного просмотра POSTSCRIPT.

• «pdf»

Устройство для программ просмотра PDF или поддерживаемых принтеров.

• «dvi»

Вывод в формате TeX DVI.

• «X75»

Вывод для средств предварительного просмотра X11 с разрешением 75 dpi.

• «X75‐12»

Вывод для средств предварительного просмотра X11 с разрешением 75 dpi и базовым шрифтом 12pt в документе.

• «X100»

Вывод для средств предварительного просмотра X11 с разрешением 100 dpi.

• «X100‐12»

Для средств предварительного просмотра X11 с разрешением 100 dpi и базовым шрифтом 12pt в документе.

• «ascii»

Форматирование для устройств типа пишущих машинок, использующих 7‐битный набор символов ASCII.

• «latin1»

Форматирование для устройств типа пишущих машинок, поддерживающих набор символов Latin‐1 (ISO 8859‐1).

• «utf8»

Для устройств типа пишущих машинок с набором символов Unicode (ISO 10646) и кодировкой UTF‐8.

• «cp1047»

Для устройств типа пишущих машинок кодировки EBCDIC IBM cp1047.

• «lj4»

Для принтеров, совместимых с HP LaserJet4 или PCL5.

• «lbp»

Для принтеров Canon CAPSL (лазерные принтеры серий LBP‐4 и LBP‐8).

• «html»

• «xhtml»

Форматирование выходных данных в форматах HTML и XHTML соответственно. Обратите внимание, что драйвер состоит из двух частей: препроцессора («pre‐ grohtml») и постпроцессора («post‐grohtml»).

Предопределенный строковый регистр gtroff «.T» содержит текущее устройство вывода; регистр только для чтения «.T» устанавливается в 1, если опция включена (что всегда верно, когда «groff» вызывает «gtroff»).

Постпроцессор устройства задается командой «postpro» в файле описания устройства, его можно переопределить с помощью опции «‐X».

• «‐U»

Небезопасный режим. Включает запросы «open», «opena», «pso», «sy» и «pi».

• «‐w name»

Включает предупреждение «name». Допускается использование нескольких вариантов «‐w».

• «‐W name»

Запрещает предупреждение «name». Допускается использование нескольких вариантов «‐W».

• «‐v»

Заставит программы, запускаемые groff, выводить номер версии.

• «‐V»

Выводит конвейер на «stdout» вместо выполнения команд потока. Если опция указана более одного раза, выведет конвейер на «stderr» (поток ошибок) и выполнит определенные команды.

• «‐X»

Предварительный просмотр с помощью программы «gxditview». Просмотр вряд ли даст удобочитаемые результаты без опции «‐Tps».

Обратите внимание, что опция отлична от «‐TX75» или «‐TX100»: в первом случае используются метрики указанного устройства, во втором применяются X‐специфичные шрифты.

• «‐z»

Подавляет вывод gtroff. Выводятся только сообщения об ошибках.

• «‐Z»

Запрещает выполнять постобработку gtroff. (Обычно groff автоматически запускает соответствующий постпроцессор.)

Переменные окружения

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

• «GROFF_BIN_PATH»

Путь поиска, за которым следует «PATH»; используется для команд, выполняемых groff.

• «GROFF_COMMAND_PREFIX»

Если установлено значение «X», то groff запускает X‐версию troff вместо gtroff. Что также относится к «tbl», «pic», «eqn», «grn», «chem», «refer» и «soelim». Не распространяется на «grops», «grodvi», «grotty», «pre‐ grohtml», «post‐grohtml», «preconv», «grolj4», «gropdf», и «gxditview».

Префикс команды определяется в процессе установки. Если найдена система troff, отличная от GNU, применяется префикс «g».

• «GROFF_ENCODING»

Значение этого параметрра среды передается препроцессору «preconv» для выбора кодировки входных файлов. Подразумевает использование параметрра командной строки «groff ‐k», в этом случае groff всегда вызывает «preconv». Если значение не задано, groff вызывает «preconv» без аргументов. Явный параметрр командной строки «‐K» переопределяет значение «GROFF_ENCODING».

• «GROFF_FONT_PATH»

Разделенный --">