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

двоеточиями список каталогов, в которых следует искать директории «dev/name».

• «GROFF_TMAC_PATH»

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

• «GROFF_TMPDIR»

Каталог, в котором groff создает временные файлы. Если переменная не определена, установлен «TMPDIR», именно в этом каталоге создаются временные файлы. В противном случае временные файлы создаются в системно‐зависимом каталоге по умолчанию. В системах Unix и GNU/Linux это обычно директория /tmp. (Программы «grops», «grefer», «pre‐grohtml» и «post‐grohtml» могут создавать временные файлы в этом каталоге.)

• «GROFF_TYPESETTER»

Устройство вывода по умолчанию.

• «SOURCE_DATE_EPOCH»

Отметка времени, считается в секундах с начала «эпохи Unix». Применяется вместо текущего времени при инициализации встроенных регистров, основанных на времени, таких как «\n[seconds]».

** Обратите внимание, что порты groff для операционных систем MS‐DOS и MS‐Windows используют точку с запятой для разделения каталогов в списках.

Каталоги макросов

Все имена файлов макросов должны называться «name.tmac» или «tmac.name». Это необходимо, чтобы опция командной строки «‐m name» корректно работала. Запрос «mso» не имеет подобного ограничения; допускается любое имя файла, gtroff не будет добавлять строку «tmac».

Файлы макросов хранятся в «каталогах tmac», каждый из которых описан как «путь tmac».

Пути поиска файлов макросов следующие: а) каталоги, указанные с помощью опции командной строки «‐M»; б) каталоги, определенные в переменной окружения «GROFF_TMAC_PATH»; г) текущий каталог (только в небезопасном режиме с ключом командной строки «‐U»); д) домашний каталог; е) каталог, зависящий от платформы или специфичный (независимый от платформы), а также основной каталог tmac.

Примеры.

:: /usr/local/lib/groff/site‐tmac

:: /usr/local/share/groff/site‐tmac

:: /usr/local/share/groff/1.22.3/tmac

** В процессе установки или компиляции программ можно самостоятельно настроить каталоги и пути.

Каталоги шрифтов

Не существует ограничений для имен файлов шрифтов, но чтобы механизм семейства шрифтов работал, шрифты должны начинаться с имени семейства, за которым следует форма. Например, семейство Times использует «T» для подгрупп «R», «B», «I» и «BI» (римский, жирный, курсив и жирный курсив или «roman», «bold», «italic», «bold italic»). В терминологии groff они также имеют сокращенные названия «TR», «TB», «TI» и «TBI».

Все файлы шрифтов хранятся в «каталогах шрифтов», определяемых как «путь к шрифтам». Функции поиска файлов всегда добавляют каталог «devname», где «name» — это имя выходного устройства.

Например, если предполагается выход на устройство DVI, где «/foo/bar» считается каталогом шрифтов, файлы шрифтов для «grodvi» должны находиться в «/foo/bar/devdvi».

Пути поиска файлов шрифтов определены следующим образом.

1. Каталоги, указанные с помощью опции командной строки «‐F». Драйверы устройств и некоторые препроцессоры также понимают эту опцию.

2. Каталоги, указанные в переменной окружения «GROFF_FONT_PATH».

3. Каталог для конкретного применения и основной каталог шрифтов; расположение по умолчанию /usr/local/share/groff/site‐font, /usr/local/share/groff/1.22.3/font.

В процессе установки программ можно настроить каталоги шрифтов самостоятельно.

Страница, размер страницы

Размер страницы программы gtroff и для устройств вывода обрабатывается раздельно.

Размер бумаги по умолчанию можно установить в файле DESC устройства. Большинство устройств вывода понимает параметр командной строки «‐p» (переопределение размера) и параметрр «‐l» (альбомная ориентация).

Для удобства установки размера бумаги существует параметрр командной строки «‐dpaper=size», определяющий строку «paper»; она обрабатывается в файле «papersize.tmac» (по умолчанию загружается в «troffrc»). Возможные значения для «size» такие же, как предопределенные значения ключевого слова «papersize» (но только в нижнем регистре), за исключением «a7», «d7». Символ «l» (ell) подразумевает альбомную ориентацию.

Например, ниже определяется вывод PS на бумаге формата A4 в альбомной ориентации.

:: groff ‐Tps ‐dpaper=a4l ‐P‐pa4 ‐P‐l ‐ms foo.ms > foo.ps

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

Примеры работы CLI

В этом разделе перечислены несколько распространенных вариантов --">