препроцессор «grap» работал с графами.

Джеймс Кларк начал работу над GNU‐реализацией ditroff в начале 1989 г. Первая версия groff 0.3.1 была выпущена в июне 1990 г. В этой версии появились следующие модификации: добавлены препроцессоры «soelim», «pic», «tbl» и «eqn», также постпроцессоры для символьных устройств, POSTSCRIPT, TeX DVI и оконной системы X Windows.

Программа GNU troff устранила необходимость в отдельной программе nroff, добавились макросы «me» и собственная реализация «man».

Начиная с 1999 года у groff появились сопровождающие (пакет несколько лет оставался сиротой). В результате добавили новые функции и программы, такие как «grn», препроцессор для изображений гремлинов и устройство вывода HTML и XHTML.

Основные возможности

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

Поскольку groff применяет сложные средства низкого уровня, чтобы упростить форматирование и для рутинной работы были созданы программы‐макросы. Макросы можно собирать вместе в «пакеты». Доступно несколько пакетов макросов, наиболее распространенными считаются «man», «mdoc», «me», «ms» и «mm».

Хотя groff предоставляет множество функций, необходимых для форматирования документа, некоторые операции, например, рисование, будет сложно реализовать простыми средствами. Поэтому были написаны программы‐препроцессоры, работающие с собственными командами управления. Препроцессоры способны отличать свои команды от других запросов с помощью маркеров.

Для передачи данных препроцессорам используются потоки Unix. Также для создания документа может применяться любое количество препроцессоров, поэтому препроцессоры объединяются в один конвейер. Чтобы работать с groff, пользователю не нужно создавать конвейер, но необходимо указать добавляемые препроцессоры.

В настоящее время groff включает препроцессоры для создания таблиц («tbl»), оформления уравнений («eqn»), рисования («pic» и «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» следующий.

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

Впрочем, многие опции 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»

Предварительная