groffer - Интернет в облаке

ПРОГРАММА:

ИМЯ

groffer - отображать файлы groff и справочные страницы на X и tty

СИНТАКСИС

гроффер [--] [спецификация файла ....]

гроффер [вариант-режим ....] [groff-варианты ....] [мужские варианты ....] [X-варианты ....]
[--] [спецификация файла ....]

гроффер -h | --Помогите

гроффер -v | --версия

ОПИСАНИЕ

" гроффер программа - самый простой способ использовать Грофф(1). Может отображать произвольные
документы, написанные в Грофф язык, см. Грофф(7) или другие ROFF языки, см.
ROFF(7), которые совместимы с оригиналом TROFF язык. Он находит и запускает все
необходимо Грофф препроцессоры, такие как химические.

" гроффер программа также включает в себя многие функции для поиска и отображения Unix
справочные страницы (человек страниц), так что его можно использовать как замену человек(1) программа.
Более того, сжатые файлы, с которыми может работать GZIP(1) или bzip2(1) распаковываются на-
муха.

Обычное использование довольно просто, указав имя файла или имя человек страница без
дальнейшие варианты. Но у опционной обработки есть много возможностей для создания особых
поведение. Это можно сделать либо в файлах конфигурации, либо в среде оболочки.
переменная $ GROFFER_OPT, или в командной строке.

Вывод можно сгенерировать и просмотреть несколькими способами, доступными для Грофф.
Это включает Грофф родной просмотрщик X Window gxditview(1), каждый Постскриптум, PDFили дви
отображать программу, веб-браузер, генерируя HTML in WWW Режим, или несколько текст Режимы in
текстовые терминалы.

Большинство параметров, которые необходимо назвать при запуске Грофф непосредственно определены
автоматически для гроффер, из-за внутреннего использования грог(1) программа. Но все
частями также можно управлять вручную с помощью аргументов.

В аргументах командной строки можно указать несколько имен файлов. Они трансформируются
в единый документ обычным способом Грофф.

Обработка опций выполняется в стиле GNU. Параметры и имена файлов можно свободно смешивать. В
вариант `--'закрывает обработку опций, все следующие аргументы рассматриваются как имена файлов.
Для длинных опций можно использовать несколько сокращений.

ВАРИАНТ О проекте

разрыв кредита

[-h | --Помогите] [-v | --версия]

гроффер Режим кредита

[--авто] [--дефолт] [- режимы по умолчанию режим1, режим2, ....] [--dvi] [--грофф]
[--html] [--latin1] [--Режим Режим отображения] [--pdf] [--pdf2] [--пс] [--источник]
[--текст] [--to-stdout] [--tty] [--utf8] [- зритель прог] [--www] [--Икс | --ИКС]

кредита Связанный в Грофф

[-T | --устройство устройство] [-Z | --промежуточный вывод | --дитрофф]

Все дальше Грофф принимаются короткие варианты.

кредита для человек страниц

[--просмотр] [--по поводу данных] [--apropos-devel] [--по поводу-проги] [--человек]
[- нет человека] [--обез особенного] [--что такое]

длинной кредита приняты за от GNU человек

[--все] [--ascii] [--дитрофф] [--расширение суффикс] [--локаль язык]
[--local-файл] [--место нахождения | --куда] [--манпат dir1: dir2: ....] [--нет местоположения]
[--пейджер программа] [- разделы сек1: сек2: ....] [--системы sys1, sys2, ....]
[--troff-устройство устройство]

Дальнейшие длинные варианты GNU человек также принимаются.

X Окно Инструментарий кредита

[--бд | --цвет границы пикселей] [--bg | --фон цвет]
[--чт | --ширина рамки пикселей] [--отображать X-дисплей] [--fg | --передний план цвет]
[--fn | - фут | --шрифт имя_шрифта] [--геометрия size_pos] [--разрешающая способность ценностное ] [--rv]
[--заглавие string] [--xrm X-ресурс]

кредита для способствовали

[--отлаживать] [--debug-имена файлов] [--debug-грог] [--debug-держать] [--debug-параметры]
[--debug-tmpdir] [--ничего не делать] [--Распечатать текст] [-V]

спецификация файла Аргументы

" спецификация файла параметры - это все аргументы, которые не являются ни опцией, ни опцией
аргумент. Обычно они означают имя файла или человек страница Схема поиска.

Далее термин раздел_расширение используется. Это означает слово, которое
состоит из человек . за которым может следовать расширение, Имя
a человек . это единственный персонаж из [1–9на], расширение какое-то слово. В
расширение в основном не хватает.

Нет спецификация файла параметры означает стандартный ввод.

- обозначает стандартный ввод (может встречаться несколько раз).

имя файла путь к существующему файлу.

мужчина:имя(раздел_расширение)
мужчина:имя.раздел_расширение
имя(раздел_расширение)
имя.раздел_расширение
раздел_расширение имя
поиск по странице руководства имя в разделе с необязательным расширением
раздел_расширение.

мужчина:имя страница руководства в самом низком человек . , которая имеет имя.

имя if имя не существует поиск файлов для справочной страницы имя в
нижняя мужская секция.

ВАРИАНТ ПОДРОБНЕЕ

" гроффер Программа обычно запускается с очень небольшим количеством параметров. Но для специальных целей,
он поддерживает множество опций. Их можно разделить на 5 классов опций.

Все короткие варианты гроффер совместимы с короткими вариантами Грофф(1). Все долго
варианты гроффер совместимы с длинными вариантами человек(1).

Аргументы для длинных имен опций можно сократить несколькими способами. Во-первых, аргумент
проверяется, можно ли его продлить как есть. Кроме того, каждый знак минус - is
считается отправной точкой для новой аббревиатуры. Это приводит к набору нескольких
сокращения для одного аргумента. Например, --de-nf может использоваться как сокращение
для --debug-не-func, Но --де-н тоже работает. Если сокращение аргумента приводит
для нескольких результирующих опций возникает ошибка.

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

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

-h | --Помогите
Распечатайте справочную информацию с кратким описанием параметров для стандартного вывода.

-v | --версия
Распечатать информацию о версии на стандартный вывод.

гроффер режим Возможности
Этими параметрами определяются режим отображения и программы просмотра. Если ни один из
эти параметры режима и средства просмотра указаны гроффер пытается найти подходящий режим отображения
автоматически. Режимы по умолчанию: Режим PDF, Режим ps, Режим HTML, Режим xи Режим дви
в X Window с разными программами просмотра и Режим терминал с устройством utf8 недооценивают ее Меньше на терминале;
другие режимы проверяются, если программы для основного режима по умолчанию не существуют.

В X Window многие программы при вызове создают собственное окно. гроффер могу запустить эти
зрители как независимая программа в фоновом режиме. Поскольку это не работает в текстовом режиме
на терминале (tty) должен быть способ узнать, какие средства просмотра являются графическими в X Window.
программы. В гроффер скрипт содержит небольшой набор информации о некоторых именах зрителей. Если
аргумент зрителя командной строки выбирает элемент, который хранится как программа X Window в
этот список рассматривается как средство просмотра, которое может работать в фоновом режиме. Все остальное, неизвестное
вызовы программы просмотра не выполняются в фоновом режиме.

Для каждого режима вы можете выбрать любого зрителя, который вам нужен. Это не должно быть
графический просмотрщик, подходящий для этого режима. Есть возможность просмотреть исходник вывода; для
Например, комбинация опций --mode = ps и --viewer = меньше показывает содержание
Постскриптум вывод, исходный код, с пейджером Меньше.

--авто Эквивалентно --mode = авто.

--дефолт
Сбросить всю конфигурацию из ранее обработанных параметров командной строки на
значения по умолчанию. Это полезно, чтобы стереть все предыдущие варианты
конфигурация, в $ GROFFER_OPT, и перезапустите обработку опций, используя только остальные
командной строки.

- режимы по умолчанию режим1, режим2, ....
Установите последовательность режимов для автоматический Режим в список, разделенный запятыми, указанный в
аргумент. Видеть --Режим для получения подробной информации о режимах. Отображать по умолчанию;
собственно, это означает попробовать режимы x, psи терминал в этой последовательности.

--dvi Эквивалентно --mode = dvi.
- зритель прог
Выберите программу просмотра для дви Режим. Это может быть имя файла или программа, которую нужно
искал в $ PATH. Известное окно X дви зрители включают xdvi(1) и двилкс(1). В
в каждом случае аргументы могут быть предоставлены дополнительно.

--грофф
Эквивалентно --mode = groff.

--html Эквивалентно --mode = html.
- зритель
Выберите программу веб-браузера для просмотра в HTML Режим. Это может быть путь к
исполняемый файл или программу в $ PATH. В каждом случае могут быть представлены аргументы.


--Режим ценностное
Установите режим отображения. Распознаются следующие значения режима:

автоматический Выберите автоматическое определение режима отображения. Последовательность
опробованные режимы можно установить с помощью - режимы по умолчанию вариант. Полезный для
восстановление по умолчанию Режим когда ранее был указан другой режим.

дви Отображение форматированного ввода в дви программа просмотра. По умолчанию отформатированный
ввод отображается с xdvi(1) программа.

Грофф После определения файла переключите гроффер для обработки ввода как
Грофф(1) подойдет. Это отключает гроффер возможности просмотра.

HTML Переведите ввод в формат html и отобразите результат в веб-браузере.
программа. По умолчанию наличие последовательности стандартных веб-браузеров
тестируется, начиная с Konqueror(1) и Mozilla(1). Просмотрщик текста html
is рысь(1).

PDF Transform ROFF вход файлов в PDF файл с помощью Грофф (1) устройство
-ТПДФ. Это по умолчанию PDF генератор. Сгенерированный PDF файл is
отображается с помощью подходящих программ просмотра, таких как окуляр(1).

PDF2 Это традиционный PDF Режим. Иногда этот режим дает более правильные
вывод, чем по умолчанию PDF Режим. По умолчанию ввод отформатирован
Грофф с помощью устройства Postscript, затем он преобразуется в файл PDF
форматирование с использованием gs(1) или ps2pdf(1). Если это невозможно, Постскриптум
Режим (Пс) вместо этого используется. Наконец, он отображается с использованием другого средства просмотра
программ.

ps Отображение форматированного ввода в программе просмотра Postscript. По умолчанию
форматированный ввод отображается в одной из многих программ просмотра.

текст Форматировать в Грофф текст Режим и запишите результат в стандартный вывод без
пейджер или программа просмотра. Текстовое устройство, latin1 по умолчанию может быть
выбрано с опцией -T.

терминал Форматировать в Грофф текст Режим и запишите результат в стандартный вывод, используя
текстовая программа-пейджер даже в X Window.

WWW Эквивалентно --mode = html.

x Отобразить форматированный ввод в собственном ROFF зритель. По умолчанию
форматированный ввод отображается с gxditview(1) программа распространяется
вместе с Грофф. Но стандартный инструмент X Window xditview(1) также может быть
выбран с опцией - зритель. Разрешение по умолчанию 75dpi, Но
100dpi также возможны. По умолчанию Грофф устройство для разрешения
75dpi is X75-12, Для 100dpi это X100, Соответствующий Грофф
промежуточный выходной для фактического устройства создается, и результат
отображается. Для разрешения 100dpi, ширина по умолчанию геометрии
программа отображения выбрана так, чтобы 850dpi.

X Эквивалентно --mode = x.

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

Грофф Сгенерировать вывод устройства с помощью простого Грофф без использования специального просмотра
особенности гроффер. Если опцией не было указано устройство -T Грофф
по умолчанию ps предполагается.

источник Вывести исходный код roff входных файлов без дальнейшей обработки.

--pdf Эквивалентно --mode = pdf.
--pdf2 Эквивалентно --mode = pdf2.
- зритель прог
Выберите программу просмотра для PDF Режим. Это может быть имя файла или программа, которую нужно
искал в $ PATH; аргументы могут быть предоставлены дополнительно.

--пс Эквивалентно --mode = ps.
- зритель прог
Выберите программу просмотра для ps Режим. Это может быть имя файла или программа, которую нужно
искал в $ PATH. Обычные программы просмотра Postscript включают окуляр(1) показывать(1) gv(1)
призрак(1), и gs(1), В каждом случае аргументы могут быть предоставлены дополнительно.

--источник
Эквивалентно --mode = источник.

--текст Эквивалентно --mode = текст.

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

--tty Эквивалентно --mode = tty.
- зритель прог
Выберите текстовый пейджер для режима терминал. Стандартный пейджер Меньше(1). Этот вариант
что эквивалентно человек вариант --pager =прог. Аргументом параметра может быть имя файла или
программа для поиска $ PATH; аргументы могут быть предоставлены дополнительно.

--www Эквивалентно --mode = html.
- зритель
прог.

--ИКС | --Икс
Эквивалентно --mode = x.
- зритель прог
Выберите программу просмотра для x Режим. Подходящие программы просмотра: gxditview(1)
что по умолчанию и xditview(1). Аргументом может быть любой исполняемый файл или
программы в $ PATH; аргументы могут быть предоставлены дополнительно.

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

Помимо этого, гроффер принимает все короткие варианты, действительные для Грофф(1) программа.
Все негроффер параметры отправляются без изменений через грог в Грофф. Итак, постпроцессоры, макро
пакеты, совместимость с классическая TROFF, и многое другое можно указать вручную.

Возможности Связанный в Грофф
Все короткие варианты гроффер совместимы с короткими вариантами Грофф(1).
следование Грофф варианты имеют либо дополнительное специальное значение в пределах гроффер or
имеет смысл для нормального использования.

Из-за особого поведения вывода Грофф вариант -Z гроффер был разработан для
быть переключенным в Грофф Режим; гроффер возможности просмотра там отключены. Другой
Грофф опции не переключают режим, но позволяют настроить процесс форматирования.

--а Это генерирует приближение ascii вывода в текст Режимы. Это могло быть
это важно, когда у текстового пейджера есть проблемы с управляющими последовательностями в терминал Режим.

--м файл
Добавить файл как Грофф файл макроса. Это полезно в случае, если его нельзя распознать
автоматически.

--П opt_or_arg
Отправить аргумент opt_or_arg в качестве опции или аргумента опции к фактическому Грофф
постпроцессор.

--Т имя разработчика | --устройство имя разработчика
Этот параметр определяет Гроффустройство вывода. Самыми важными устройствами являются
устройства вывода текста для ссылки на различные наборы символов, такие как ASCII,
utf8, latin1, utf8, и другие. Каждый из этих аргументов переключает гроффер в
текст Режим используя это устройство, чтобы Режим терминал если фактический режим не текст Режим.
Следующие имя разработчика аргументы отображаются в соответствующие гроффер
--mode =имя разработчика опции: дви, HTMLи ps. Все X* аргументы отображаются на Режим x.
Друг с другом имя разработчика аргумент переключается на Режим Грофф используя это устройство.

--ИКС эквивалентна Грофф -X. Он отображает Грофф промежуточный выходной
gxditview. Поскольку качество относительно низкое, эта опция устарела; использовать --ИКС
вместо этого, потому что x Режим использует X* устройство для лучшего отображения.

-Z | --промежуточный вывод | --дитрофф
Переключиться на Грофф Режим и отформатируйте ввод с помощью Грофф промежуточный выходной
без постобработки; видеть groff_out(5). Это эквивалентно варианту --дитрофф
of человек, который также можно использовать.

Все другие Грофф варианты поддерживаются гроффер, но они просто прозрачно
перемещенный в Грофф без какого-либо вмешательства. Параметры, которые явно не указаны
обрабатывается гроффер прозрачно передаются Грофф. Поэтому эти прозрачные параметры
не задокументированы здесь, но в Грофф(1). За счет автоматизма в гроффер, ни один из этих
Грофф параметры должны быть необходимы, за исключением расширенного использования.

Возможности для человек страниц
--просмотр
Запустите по поводу(1) командование или средство человек(1) для поиска спецификация файла
аргументы во всех человек страница описания. Каждый спецификация файла аргумент берется за
искать как есть; . определенные части не обрабатываются, так что 7 Грофф поиск
за два аргумента 7 и Грофф, с большим результатом; для спецификация файла Грофф.7
ничего не будет найдено. В язык локаль обрабатывается только тогда, когда вызываемый
программы действительно поддерживают это; GNU по поводу и человек -k не надо. Дисплей отличается
из по поводу программа по следующим концепциям:

* Построить Грофф рама, похожая на человек страница к выходу по поводу,

* каждый спецификация файла аргумент ищется сам по себе.

* Ограничение по - разделы также обрабатывается,

* символы подстановки разрешены и обрабатываются без дополнительных опций.

--по поводу данных
Показать только по поводу описания документов с данными, это человек(7)
разделах 4, 5и 7, непосредственный . объявления игнорируются, подстановочные знаки
принимаются.

--apropos-devel
Показать только по поводу описания документов разработки, это человек(7)
разделах 2, 3и 9, непосредственный . объявления игнорируются, подстановочные знаки
принимаются.

--по поводу-проги
Показать только по поводу описания документов по программам, это человек(7)
разделах 1, 6и 8, непосредственный . объявления игнорируются, подстановочные знаки
принимаются.

--что такое
Для каждого спецификация файла аргумент искать все человек страниц и отобразить их описание - или
сказать, что это не человек страница. Это написано заново, поэтому отличается от человек's
что такое вывод по следующим концепциям

* добавляется имя каждого полученного файла,

* также обрабатываются локальные файлы,

* язык и система локаль поддерживается,

* дисплей обрамлен Грофф выходной формат похож на человек страница,

* символы подстановки разрешены без дополнительных опций.

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

--человек Проверьте аргументы командной строки без параметров (спецификации файлов) сначала на то, чтобы быть человек страниц,
затем представляют ли они существующий файл. По умолчанию спецификация файла первый
проверил, является ли это существующим файлом.

- нет человека | --local-файл
Не проверяйте человек страниц. --local-файл является соответствующим человек опцию.

--обез особенного
Отключить предыдущие вызовы --все, --apropos *и --что такое.

Длинное кредита приняты за от GNU человек
Длинные варианты гроффер были синхронизированы с длинными вариантами GNU человек. Все долго
варианты GNU человек распознаются, но не все эти параметры важны для гроффер,
поэтому большинство из них просто игнорируются. Эти проигнорированные человек варианты --кэтмен, --троффи
--Обновить.

В дальнейшем человек варианты, которые имеют особое значение для гроффер документированы

Если в вашей системе есть GNU человек установил полный набор длинных и коротких опций GNU человек
программа может быть передана через переменную окружения $ MANOPT; увидеть человек(1).

--все В поисках человек страниц, получить все подходящие документы вместо одного.

-7 | --ascii
In текст Режимы, отображать ASCII-перевод специальных символов для критических
среда. Это эквивалентно Грофф -mtty_char; увидеть groff_tmac(5).

--дитрофф
Производит Грофф промежуточный выходной, Это эквивалентно гроффер -Z.

--расширение суффикс
ограничивать человек страница поиск по именам файлов, в которых есть суффикс добавлен к их разделу
элемент. Например, в имени файла /usr/share/man/man3/terminfo.3ncurses.gz
человек страница расширение Ncurses.

--локаль язык
Установите язык для человек страниц. Это имеет тот же эффект, но перезаписывает $ LANG.

--место нахождения
Вывести расположение извлеченных файлов в стандартную ошибку.

--нет местоположения
Не отображать расположение извлеченных файлов; это сбрасывает предыдущий вызов
--место нахождения. Это было добавлено гроффер.

--манпат 'dir1: dir2: ....'
Использовать указанный путь поиска для получения человек страниц вместо программы
по умолчанию. Если в качестве аргумента задана пустая строка "", поиск человек страница is
отключен.

--пейджер
Установите программу пейджера в терминал Режим; по умолчанию Меньше. Это можно установить с помощью - зритель.

- разделы сек1: сек2: ....
Ограничить поиск человек страниц к данному разделах, список, разделенный двоеточиями.

--системы sys1, sys2, ....
Найдите человек страниц для данных операционных систем; Аргумент системы - это
Список, разделенный запятыми.

--куда
Эквивалентно --место нахождения.

X Окно Инструментарий Возможности
Следующие длинные параметры были адаптированы из соответствующих параметров X Window Toolkit.
гроффер передаст их реальной программе просмотра, если это программа X Window.
В противном случае эти параметры игнорируются.

К сожалению, эти варианты используют старый стиль единственного минуса для длинных вариантов. Для
гроффер который был изменен на стандартный с использованием двойного минуса для длинных опций, для
пример, гроффер использует опцию --шрифт для опции X Window -шрифт.

Увидеть X(7) и документацию по параметрам X Window Toolkit для получения более подробной информации об этих
варианты и их аргументы.

--фон цвет
Установите цвет фона окна просмотра.

--бд пикселей
Это эквивалентно --цвет границы.

--bg цвет
Это эквивалентно --фон.

--чт пикселей
Это эквивалентно --ширина рамки.

--цвет границы пикселей
Задает цвет рамки, окружающей окно просмотра.

--ширина рамки пикселей
Задает ширину в пикселях границы, окружающей окно просмотра.

--отображать X-дисплей
Установите отображение X Window, на котором должна запускаться программа просмотра, см.
Документация X Window по синтаксису аргумента.

--передний план цвет
Установите цвет переднего плана окна просмотра.

--fg цвет
Это эквивалентно --передний план.

--fn имя_шрифта
Это эквивалентно --шрифт.

--шрифт имя_шрифта
Установите шрифт, используемый в окне просмотра. Аргументом является имя шрифта X Window.

- фут имя_шрифта
Это эквивалентно --шрифт.

--геометрия size_pos
Задайте геометрию окна дисплея, то есть его размер и начало
должность. Видеть X(7) для синтаксиса аргумента.

--разрешающая способность ценностное
Установите разрешение X Window в dpi (точек на дюйм) в некоторых программах просмотра. Единственный
поддерживаемые значения dpi: 75 и 100. На самом деле разрешение по умолчанию для гроффер
на 75dpi. Разрешение также устанавливает устройство по умолчанию в Режим x.

--rv Обратный цвет переднего плана и фона окна просмотра.

--заглавие 'некоторый текст'
Задайте заголовок для окна просмотра.

--xrm 'ресурс'
Установить ресурс X Window.

Возможности для Разработка
--отлаживать
Включить все параметры отладки --отлаживать-напишите. Временные файлы сохраняются и не
удалено, грог вывод выводится на печать, имя временного каталога
напечатаны, отображаемые имена файлов будут напечатаны, а параметры напечатаны.

--debug-имена файлов
Выведите имена файлов и человек страниц которые отображаются гроффер.

--debug-грог
Распечатать вывод всех грог команды.

--debug-держать
Включите две отладочной информации. Выведите имя временного каталога и
храните временные файлы, не удаляйте их во время запуска гроффер.

--debug-параметры
Распечатайте параметры, полученные из файлов конфигурации, из GROFFER_OPT,
и аргументы командной строки.

--debug-tmpdir
Выведите имя временного каталога.

--ничего не делать
Это похоже на --версия, но без вывода; программа просмотра не запускается. Это делает
только смысл в развитии.

--print =текст
Просто выведите аргумент стандартной ошибки. Это хорошо для проверки параметров.

-V Это расширенный вариант только для отладки. Вместо отображения отформатированного
ввод, много гроффер конкретная информация выводится на стандартный вывод:

* имя выходного файла во временном каталоге,

* режим отображения актуальных гроффер бежать,

* программа отображения для просмотра вывода с его аргументами,

* активные параметры из конфигурационных файлов, аргументы в $ GROFFER_OPTи
аргументы командной строки,

* конвейер, которым будет управлять Грофф программу, но не выполняя ее.

Другие полезные параметры отладки: Грофф вариант -Z и --mode = groff.

Спецификация файла аргументы
A спецификация файла параметр - это аргумент, который не является параметром или аргументом параметра. В гроффер,
спецификация файла параметры - это имя файла или шаблон для поиска человек страниц. Эти входные
источники собираются и объединяются в один выходной файл, например Грофф делает.

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

Варианты --apropos * иметь особое отношение к спецификация файла аргументы. Каждый аргумент
взяты как собственная поисковая схема. Также регулярное выражение (regexp) можно использовать в
спецификация файлов. Например, гроффер --просмотр '^ gro.f $' поиск Грофф в человек страница
имя, а гроффер --просмотр Грофф поиск Грофф где-то в названии или описании
человек страниц.

Все остальные части гроффер, например, нормальный дисплей или вывод с --что такое есть
другая схема для спецификации файлов. Для аргументов не используются регулярные выражения. В
спецификация файла Аргументы обрабатываются по следующей схеме.

Необходимо знать, что в каждой системе человек страниц сортируются по их
содержание в несколько разделов. В классическая человек разделах иметь односимвольное имя,
либо цифра из 1 в 9 или один из персонажей n or o.

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

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

* Нет спецификация файла параметры означает, что гроффер ждет стандартного ввода. Минус вариант -
всегда означает стандартный ввод; это может происходить несколько раз. Если вы хотите найти
человек страница под названием - использовать аргумент человек:-.

* Далее спецификация файла проверяется, является ли это именем пути к существующему файлу. В противном случае это
предполагается, что это шаблон поиска для человек страница.

* мужчина:имя(раздел_расширение), мужчина:имя.расширение_раздела, имя(раздел_расширение), or
имя.раздел_расширение поиск по странице руководства имя в разделе man и, возможно, расширение
раздел_расширение.

* Теперь мужчина:имя ищет человек страница в самом низком человек . у которого есть документ
под названием имя.

* раздел_расширение имя это шаблон из двух аргументов, который происходит от странного
анализ аргументов человек программа. Опять же, выполняется поиск на странице руководства имя
раздел_расширение, сочетание . символ, за которым может следовать
расширение.

* Остается аргумент имя которого не существует. Итак, это ищет
человек страница под названием имя в самом низком человек . у которого есть документ на это имя.

Могут быть указаны несколько аргументов имени файла. Они смешаны Грофф в один
документ. Обратите внимание, что набор аргументов опции должен соответствовать всем этим аргументам файла.
Таким образом, они должны иметь хотя бы один и тот же стиль Грофф язык.

ВЫВОД РЕЖИМЫ

По умолчанию, гроффер программа собирает весь ввод в один файл, форматирует его
Грофф программа для определенного устройства, а затем выбирает подходящую программу-просмотрщик. В
устройство и просмотрщик в гроффер называется Режим. Режим и средство просмотра бега
гроффер программа выбирается автоматически, но пользователь также может выбрать ее с опциями.
Режимы выбираются опцией аргументы --mode =любой режим. Кроме того, каждый из
этот аргумент можно указать как отдельную опцию, например любой режим, Большинство из них
В режимах есть программа просмотра, которую можно выбрать по желанию - зритель.

Предлагаются несколько различных режимов, графические режимы для X Window, текст Режимы, и немного
направлять Грофф Режимы для отладки и разработки.

По умолчанию гроффер сначала пытается ли x Режим возможно, тогда ps Режим, и наконец
терминал Режим. Последовательность тестирования этого режима для автоматический Режим можно изменить, указав запятую
разделенный список режимов с опцией - режимы по умолчанию.

В поисках человек страниц и декомпрессия входа активны в каждом режиме.

Графический Дисплей Режимы
Графические режимы отображения работают в основном в среде X Window (или аналогичной
реализации в других оконных средах). Переменная окружения $ ДИСПЛЕЙ
и вариант --отображать используются для указания используемого дисплея X Window. Если это
переменная среды пуста гроффер предполагает, что X Window не запущено, и меняется на
текст Режим. Вы можете изменить это автоматическое поведение с помощью опции - режимы по умолчанию.

Известные программы просмотра для графических режимов отображения и их стандартные программы просмотра X Window


* в программе просмотра PDF (PDF Режим)

* в веб-браузере (HTML or WWW Режим)

* в программе просмотра Postscript (ps Режим)

* Окно Х ROFF зрители, такие как gxditview(1) или xditview(1) (в x Режим)

* в программе просмотра dvi (дви Режим)

" PDF Режим имеет большое преимущество - это единственный графический режим отображения, который позволяет
поиск текста в программе просмотра; это может быть действительно важной особенностью. К несчастью,
преобразование входных данных в формат PDF занимает некоторое время, поэтому он не был выбран в качестве
основной режим.

Эти графические средства просмотра можно настроить с помощью параметров X Window Toolkit. Но
гроффер варианты используют ведущий двойной минус вместо одиночного минуса, используемого
Инструментарий XWindow.

Текст Режимы
Есть два режима вывода текста: Режим текст для простого вывода без пейджера и
Режим терминал для вывода текста на текстовый терминал с помощью какой-нибудь программы-пейджера.

Если переменная $ ДИСПЛЕЙ не задано или пусто, гроффер предполагает, что он должен использовать терминал Режим.

В реальной реализации Грофф устройство вывода latin1 выбран для текст Режимы.
Это можно изменить, указав опцию -T or --устройство.

Используемый пейджер можно указать одним из параметров --пейджер и - зритель, Или
переменная окружения $ PAGER. Если все это не используется, Меньше(1) программа с
вариант -r для правильного отображения управляющих последовательностей используется как пейджер по умолчанию.

Особый Режимы для Отладка и Разработка
В этих режимах используется гроффер определение и распаковка файлов. Это объединено в
один входной файл, который подается непосредственно в Грофф с другой стратегией без
гроффер просмотр объектов. Эти режимы считаются расширенными, они полезны для
в целях отладки и разработки.

" источник Режим с опцией --источник просто отображает распакованный ввод.

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

" Грофф Режим передает ввод в Грофф используя только некоторые подходящие варианты, предоставленные
гроффер. Это позволяет пользователю сохранить сгенерированный вывод в файл или передать его в
другая программа.

In Грофф Режим, опция -Z отключает постобработку, таким образом создавая Грофф
промежуточный выходной. В этом режиме ввод форматируется, но не подвергается постобработке; видеть
groff_out(5) для подробностей.

Все Грофф короткие варианты поддерживаются гроффер.

ЧЕЛОВЕК СТР ПОИСКИ

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

--человек заставляет интерпретировать все параметры файла как спецификации файлов для поиска человек страниц.

- нет человека
--local-файл
отключить человек поиск; поэтому отображаются только локальные файлы.

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

Поиск Алгоритм
Предположим теперь, что a человек страница следует искать. В гроффер программа предусматривает
средство поиска для человек страниц. Все длинные параметры, все переменные среды и большая часть
функциональность GNU человек(1) программа была реализована. Алгоритм поиска должен
определить, какой файл отображается для данного человек страница. Процесс может быть изменен
параметры и переменные среды.

Только человек действие, которое пропущено в гроффер предварительно отформатированы человек страниц, Которая также называется
кошка страниц. Благодаря отличной производительности реальных компьютеров, предварительно отформатированный
человек страниц больше не нужны. Кроме того, гроффер - это ROFF программа; он хочет
читать ROFF исходные файлы и отформатировать их самостоятельно.

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

" человек путь это список каталогов, разделенных двоеточием. Он генерируется
следующие методы.

* Переменная окружения $ MANPATH можно установить.

* Его можно прочитать из аргументов переменной окружения $ MANOPT.

* человек путь можно указать вручную с помощью параметра --манпат. Пустой аргумент
отключает человек страница поиск.

* Когда нет человек путь был установлен MANPATH(1) программа пытается его определить.

* Если это не работает, разумный путь по умолчанию из $ PATH определен.

Теперь у нас есть стартовый набор каталогов. Первый способ изменить этот набор - добавить
имена операционный системы. Это предполагает, что человек страниц для нескольких операционный системы
установлены. Это не всегда правда. Имена таких операционный системы может быть предоставлен
3 способами.

* Переменная окружения $ SYSTEM имеет самый низкий приоритет.

* Это может быть отменено опцией в $ MANOPT.

* Это снова отменяется параметром командной строки --системы.

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

" человек путь изменяется путем добавления каждого система имя как подкаталог в конце каждого
каталог набора. Нет справочника человек путь набор сохраняется. Но если нет система имя
указал человек путь остается без изменений.

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

* Переменная окружения $ LANG.

* Это отменяется $ LC_MESSAGES.

* Это отменяется $ LC_ALL.

* Это можно изменить, указав параметр в $ MANOPT.

* Все эти переменные среды переопределяются параметром командной строки --локаль.

" по умолчанию язык можно указать, указав один из параметров псевдоязыка
C или POSIX. Это похоже на удаление ранее заданного язык Информация. В человек страниц
в по умолчанию язык обычно на английском.

Конечно, язык имя определяется человек. В GNU человек, это указано в
Формат на основе POSIX 1003.1:

[_[.[,]]],

но двухбуквенный код в достаточно для большинства целей. Если для
сложный язык формулировка нет человек страниц найдены гроффер ищет часть страны
состоящий также из этих первых двух символов.

Фактический набор каталогов копируется трижды. В язык имя добавляется как подкаталог
в каждый каталог в первой копии фактического набора каталогов (это делается только тогда, когда
дается информация о языке). Затем двухбуквенное сокращение язык имя
добавляются как подкаталоги ко второй копии набора каталогов (это делается только тогда, когда
название данного языка состоит более чем из 2 букв). Третья копия набора каталогов
остается без изменений (если нет язык информация дается, это сохраненный набор каталогов).
Эти максимум 3 копии добавляются для получения нового набора каталогов.

Теперь у нас есть полный набор каталогов для работы. В каждом из этих каталогов
человек файлы разделены на разделах. Имя . представлен одним
символ, цифра между 1 и 9, или персонаж o or n, в этом порядке.

Для каждого доступного ., подкаталог человек существует, содержащий все человек файлов
для этого ., Где представляет собой одиночный символ, как описано ранее. Каждый человек
файл в . каталог имеет вид
человек/.[ ] [.], Где и
являются необязательными. это имя человек страница который также указывается как
аргумент filespec в командной строке.

" расширение это дополнение к разделу. Этот постфикс действует как подраздел. An
расширение встречается только в имени файла, а не в имени . подкаталог. Оно может
быть указанным в командной строке.

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

Есть 4 способа указать . в командной строке:

* Переменная окружения $ MANSECT

* Параметр командной строки - разделы

* Приложение к имя аргумент в форме .

* Предварительные аргументы перед имя аргумент в форме

Также возможно указать несколько разделах добавляя отдельные символы
разделенные двоеточиями. Можно представить, что это означает ограничение человек страница искать в
только некоторые разделах. Множественные разделах возможны только для $ MANSECT и - разделы.

Если нет . указано все разделах ищутся один за другим в заданном
порядок, начиная с . 1, пока не будет найден подходящий файл.

Есть 4 метода указать расширение в командной строке. Но это не обязательно
чтобы предоставить полное имя расширения, в большинстве случаев достаточно некоторого сокращения.

* Переменная окружения РАСШИРЕНИЕ

* Параметр командной строки --расширение

* Приложение к . аргумент в форме .

* Предварительные аргументы перед имя аргумент в форме

Для получения дополнительной информации о человек страница ищу, смотри человек(1).

Примеры of человек файлов
/usr/доля/мужчина/мужчина1/грофф.1
Это несжатый файл для человек страница ворчание в . 1. Это можно назвать
by
ш # Гроффер Грофф
Нет . здесь указано, поэтому все разделах следует искать, но как . 1
сначала выполняется поиск, этот файл будет найден первым. Имя файла состоит из
следующие компоненты. / usr / share / man / должен быть частью человек путь;
подкаталог man1 / и часть .1 стоять за .; Грофф это имя
человек страница.

/usr/local/share/man/man7/groff.7.gz
Имя файла состоит из следующих компонентов. / USR / местные / доля / человек должен
быть частью человек путь; подкаталог man7 / и часть .7 стоять за
.; Грофф это имя человек страница; заключительная часть .gz выступает за
сжатие с GZIP(1). Как . не первый, это необходимо указать
также. Это можно сделать с помощью одной из следующих команд.
ш # Гроффер Грофф.7
ш # гроффер 7 грофф
ш # groffer --sections = 7 groff

/usr/local/man/man1/ctags.1emacs21.bz2
Здесь / usr / местные / человек должно быть в человек путь; подкаталог man1 / и имя файла
.1 стоять за . 1; имя человек страница is Ctags; в разделе есть
расширение emacs21; и файл сжимается как . Bz2 bzip2(1). Файл может
можно просмотреть с помощью одной из следующих команд
ш # Грофер ctags.1e
ш # Грофер 1e ctags
ш # groffer --extension = e --sections = 1 ctags
где e - сокращение от расширения emacs21.

/usr/man/linux/de/man7/man.7.Z
Каталог / usr / человек в настоящее время является частью человек путь; тогда есть подкаталог
для операционный система имя linux /; далее идет подкаталог де / для немца
язык; . имена man7 и .7 известны до сих пор; человек это имя
человек страницаи .Z означает сжатие, которое может быть обработано GZIP(1). Мы хотим
Теперь покажем, как задать несколько значений для некоторых параметров. Это возможно для
разделах и операционный система имена. Итак, мы используем как разделах 5 и 7 и как система
имена Linux и AIX. Затем команда

ш # groffer --locale = de --sections = 5: 7 --systems = linux, aix man
ш # LANG = de MANSECT = 5: 7 SYSTEM = linux, aix groffer man

ДЕКОМПРЕССИЯ

В программе есть возможность декомпрессии. Если стандартный ввод или файл, который был получен
из параметров командной строки сжимается с форматом, который поддерживается либо
GZIP(1) или bzip2(1) он распаковывается на лету. Это включает GNU .gz, . Bz2и
традиционный .Z сжатие. Программа отображает конкатенацию всех
распакованный ввод в последовательности, указанной в командной строке.

ОКРУЖАЮЩАЯ СРЕДА

" гроффер программа поддерживает множество системных переменных, большинство из них предоставлено другими
программы. Все переменные среды Грофф(1) и GNU человек(1) и некоторая стандартная система
переменные соблюдаются.

Родной гроффер Переменные
$ GROFFER_OPT
Варианты магазина для пробега гроффер. Параметры, указанные в этой переменной:
переопределено параметрами, указанными в командной строке. Содержание этой переменной
запускается через оболочку, встроенную в eval; поэтому аргументы, содержащие пробел или
должны быть заключены в кавычки специальные символы оболочки. Не забудьте экспортировать эту переменную,
в противном случае он не существует во время выполнения гроффер.

Система Переменные
Следующие переменные имеют особое значение для гроффер.

$ ДИСПЛЕЙ
Если эта переменная установлена, это означает, что система X Window работает.
При тестировании этой переменной решается, будет ли генерироваться графический или текстовый вывод.
Пользователь не должен изменять эту переменную по неосторожности, но ее можно использовать для
запустить графический гроффер на удаленном терминале X Window. Например, в зависимости от
в вашей системе, гроффер можно запустить на втором мониторе командой

ш # DISPLAY =: 0.1 groffer what.ever &

$ LC_ALL
$ LC_MESSAGES
$ LANG Если одна из этих переменных установлена ​​(в указанной выше последовательности), ее содержимое будет
интерпретируется как локаль, язык, который будет использоваться, особенно при извлечении
человек страниц. Имя локали обычно имеет форму
язык[_территория[.набор кодов[@изменение]]], куда язык это язык ISO 639
код, территория это код страны ISO 3166, и набор кодов это набор символов или
идентификатор кодировки типа ISO-8859-1 или UTF-8; видеть установить локаль(3). Значения локали
C и POSIX обозначают значение по умолчанию, т. Е. человек страница каталоги без языка
приставка. Это то же самое поведение, что и когда все 3 переменные не установлены.

$ PAGER Эта переменная может использоваться для установки пейджера для вывода tty. Например, чтобы
отключить использование пейджера полностью установить эту переменную в кошка(1) программа

ш # ПЕЙДЖЕР = кот гроффер что угодно

$ PATH Все программы в гроффер скрипт вызывается без фиксированного пути. Таким образом, это
переменная среды определяет набор программ, используемых при запуске гроффер.

Грофф Переменные
" гроффер программа внутренних вызовов Грофф, поэтому все переменные среды, задокументированные в
Грофф(1) используются внутри компании гроффер также. Следующая переменная имеет прямое
значение для гроффер программу.

$ GROFF_TMPDIR
Если значением этой переменной является существующий каталог с возможностью записи, гроффер использует это
для хранения временных файлов, так же как Грофф делает. Увидеть Грофф(1) справочная страница для
подробнее о расположении временных файлов.

Мужчина Переменные
Части функциональности человек программа была реализована в гроффер; поддержка для всех
переменные среды, задокументированные в человек(1) был добавлен в гроффер, но смысл был
немного изменен из-за другого подхода в гроффер; но пользовательский интерфейс - это
тем же. В человек переменные среды могут быть перезаписаны параметрами, предоставленными с $ MANOPT,
который, в свою очередь, перезаписывается командной строкой.

РАСШИРЕНИЕ
Ограничить поиск человек страниц к файлам с этим расширением. Это
отменено опцией --расширение; подробности см. там.

$ MANOPT
Эта переменная содержит параметры в качестве предустановки для человек(1). Поскольку не все из них
актуально для гроффер извлекаются только существенные части его стоимости. В
параметры, указанные в этой переменной, перезаписывают значения другой среды
переменные, относящиеся к человек. Все параметры, указанные в этой переменной, являются
переопределено параметрами, указанными в командной строке.

$ MANPATH
Если установлено, эта переменная содержит каталоги, в которых человек страница деревья
хранится. Это отменяется опцией --манпат.

$ MANSECT
Если это список названий разделов, разделенных двоеточиями, поиск человек страниц is
ограничены этими разделами руководства в указанном порядке. Это отменяется опцией
- разделы.

$ SYSTEM
Если для этого параметра задан список имен, разделенных запятыми, они интерпретируются как человек страница
деревья для разных операционных систем. Эта переменная может быть перезаписана опцией
--системы; подробности см. там.

Переменная окружения $ MANROFFSEQ игнорируется гроффер потому что необходимо
препроцессоры определяются автоматически.

КОНФИГУРАЦИЯ FILES

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

/etc/groff/groffer.conf
Общесистемный файл конфигурации для гроффер.

$ HOME / .groff / groffer.conf
Пользовательский файл конфигурации для гроффер, Где $ HOME обозначает дом пользователя
каталог. Этот файл вызывается после общесистемного файла конфигурации, чтобы включить
переопределение пользователем.

Оба файла обрабатываются для конфигурации, но файл конфигурации в / и т.д. выходит
первый; он перезаписывается файлом конфигурации в домашнем каталоге; оба
файлы конфигурации перезаписываются переменной окружения $ GROFFER_OPT; все
перезаписывается аргументами командной строки.

Файлы конфигурации содержат параметры, которые должны вызываться по умолчанию для каждого гроффер
бег. Эти параметры записаны в строках, каждая из которых содержит либо длинный вариант, либо
короткий вариант или кластер коротких опционов; каждый с аргументом или без него. Итак, каждая строка
информация о конфигурации начинается с символа минус `-'; линия с длинным
опция начинается с двух минусовых символов `--', строка с коротким вариантом или коротким вариантом
кластер начинается с единственного минуса `-'.

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

Аргумент для длинной опции может быть отделен от имени опции равным
знак='или пробелом, т. е. одним или несколькими пробелами или символами табуляции. Аргумент в пользу
короткий вариант или короткий кластер вариантов можно напрямую добавить к имени параметра или
разделенные пробелом. Конец аргумента - это конец строки. Нет
разрешено использовать переменную среды оболочки в имени параметра или аргументе.

Не обязательно использовать кавычки в опции или аргументе, за исключением пустых аргументов.
Пустой аргумент может быть предоставлен путем добавления пары кавычек к разделяющему равному
знак или пробел; при использовании короткого варианта разделитель также можно не устанавливать. Надолго
вариант с разделительным знаком равенства `=', пару кавычек можно опустить, таким образом заканчиваясь
черта с разделительным знаком равенства. Все остальные кавычки отменяются
внутренне.

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

Все строки конфигурационных строк, которые не начинаются с символа минуса, игнорируются,
такие, что комментарии, начинающиеся с `#'возможны. Таким образом, в
конфигурационные файлы.

В качестве примера рассмотрим следующий файл конфигурации, который можно использовать либо в
/etc/groff/groffer.conf or ~ / .groff / groffer.conf .

# файл конфигурации groffer
#
# параметры гроффера, которые используются при каждом вызове гроффера
--foreground = Темно-синий
--resolution = 100
--viewer = gxditview -geometry 900x1200
--просмотрщик xpdf -Z 150

Строки, начинающиеся с # просто игнорируются, поэтому они действуют как командные строки. Этот
конфигурация устанавливает четыре гроффер options (строки, начинающиеся с `-'). Это
следующие эффекты:

* Используйте цвет текста Темно-синий у всех зрителей, которые поддерживают это, например gxditview.

* Используйте разрешение 100dpi у всех зрителей, которые поддерживают это, например gxditview. Durch,en
это устройство по умолчанию в x Режим на X100.

* Сила gxditview(1) как x-режим просмотрщик, использующий опцию геометрии для установки ширины
в 900px и высота до 1200px. Эта геометрия подходит для разрешения
100dpi.

* Использование xpdf(1) как pdf-режим зритель с аргументом -Z 150.

ПРИМЕРЫ

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

ш # Гроффер /usr/local/share/doc/groff/meintro.ms.gz

Распаковать, отформатировать и отобразить сжатый файл meintro.ms.gz в каталоге
/ USR / местные / доля / док / groff, используя стандартную программу просмотра gxditview как средство просмотра графики, когда
в X Window или Меньше(1) программа-пейджер вне X Window.

ш # Гроффер Грофф

Если файл ./грофф существует, используйте его как ввод. В противном случае интерпретируйте аргумент как поиск
для человек страница названный Грофф в минимально возможном человек ., будучи разделом 1 в этом
дело.

ш # человек-гроффер: groff

искать человек страница of Грофф даже когда файл ./грофф существует.

ш # Гроффер Грофф.7
ш # гроффер 7 грофф

искать человек страница of Грофф in человек . 7. В этом разделе поиск работает только по цифре
или один персонаж из небольшого набора.

ш # Грофер fb.modes

Если файл ./fb.modes не существует интерпретировать это как поиск человек страница of
fb.modes. Как расширение Режимы не является ни одним персонажем в классическом стиле раздела
аргумент не разделяется на поиск fb.

ш # Гроффер ГроффTROFF(1) 'человек: roff

Аргументы, которых нет в файлах, ищутся следующим образом человек страниц: Грофф
(автоматический поиск, должен быть найден в человек секция 1), TROFF (в разделе 1), и ROFF (в
раздел с наименьшим номером, в данном случае 7). Цитаты вокруг "TROFF(1) '
необходимы, потому что круглые скобки являются специальными символами оболочки; убегая от них с помощью
символ обратной косой черты \( и \) тоже возможно. Отформатированные файлы
объединены и отображены как одно целое.

ш # LANG = de groffer --man --viewer = galeon ls

Получить немецкий человек страница (язык de) для ls программу, распаковать, отформатировать в
HTML формат (WWW Режим) и просмотрите результат в веб-браузере галеон. Опция --человек
гарантирует, что человек страница извлекается, даже если локальный файл ls существует в реальном
каталог.

ш # groffer --source 'человек:ROFF(7)»

Получите человек страница под названием ROFF in человек раздел 7, распакуйте его и распечатайте неформатированный
контент, его исходный код.

ш # Грофер --де-п --ин --ап

Это набор сокращенных аргументов, он определяется как

ш # groffer --debug-params --intermediate-output --apropos

ш # файл кота.gz | Гроффер -Z -mfoo

Файл файл.gz отправляется на стандартный ввод, распаковывается, а затем
перевезен в Грофф промежуточный выходной Режим без постобработки (Грофф вариант
-Z), используя пакет макросов Foo (Грофф вариант -m).

ш # echo '\ f [CB] ВАУ!' |
> groffer --x --bg red --fg yellow --geometry 200x100 -

Показать слово WOW! в маленьком окне жирным шрифтом постоянной ширины, желтым цветом на
красный фон.

СОВМЕСТИМОСТЬ

" гроффер программа написана на Perl, версия Perl на момент написания была v5.8.8.

гроффер предоставляет собственный синтаксический анализатор аргументов командной строки, совместимый с обоими
POSIX Getopts(1) и GNU Getopt(1). Он может обрабатывать аргументы опций и имена файлов.
содержащие пробелы и большой набор специальных символов. Следующий стандарт
типы опций поддерживаются.

* Вариант, состоящий из одного минуса - относится к стандартному вводу.

* Одиночный минус, за которым следуют символы, относится к одиночному символу или
их сочетание; например, гроффер комбинация коротких опционов -Qmfoo is
что эквивалентно -Q -m Foo.

* Длинные варианты - это варианты, имена которых длиннее одного символа; им всегда предшествуют
двойным минусом. Аргумент option может перейти к следующему аргументу командной строки
или быть добавленным к аргументу знаком равенства; Например, --long = аргумент эквивалентно
в --длинный аргумент.

* Аргумент -- завершает парсинг опции; все остальные аргументы командной строки
интерпретируется как спецификация файла параметры, то есть имена файлов или конструкции для поиска
человек страниц).

* Все аргументы командной строки, которые не являются ни параметрами, ни аргументами параметров, интерпретируются
as спецификация файла параметры и сохраняются до завершения анализа параметров. Например,
командной строки

ш # groffer файл1 -a -o arg file2

эквивалентна

ш # groffer -a -o arg - файл1 файл2

Бесплатное смешение опций и спецификация файла параметры следует принципу GNU. Что делает
не выполнять странное поведение опций POSIX, которое завершает обработку опций, как только
достигнут первый неопциональный аргумент. Окончание обработки опциона может быть
принудительно опцией `--' в любом случае.

Используйте гроффер онлайн с помощью сервисов onworks.net