969 lines
62 KiB
HTML
969 lines
62 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of MAN</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>MAN</H1>
|
||
Section: Утилиты просмотра справочных страниц (1)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
||
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
||
|
||
<A NAME="lbAB"> </A>
|
||
<H2>НАЗВАНИЕ</H2>
|
||
|
||
man - доступ к системным справочным страницам
|
||
<A NAME="lbAC"> </A>
|
||
<H2>СИНТАКСИС</H2>
|
||
|
||
|
||
|
||
<B>man</B> [<I>параметры man</I>] [[<I>раздел</I>] <I>страница</I> ...] ...
|
||
<BR>
|
||
|
||
|
||
<B>man</B> <B>-k</B> [<I>параметры apropos</I>] <I>регвыр</I> ...
|
||
<BR>
|
||
|
||
|
||
<B>man</B> <B>-K</B> [<I>параметры man</I>] [<I>раздел</I>] <I>термин</I> ...
|
||
<BR>
|
||
|
||
|
||
<B>man</B> <B>-f</B> [<I>whatis</I> <I>параметры</I>] <I>страница</I> ...
|
||
<BR>
|
||
|
||
|
||
<B>man</B> <B>-l</B> [<I>параметры man</I>] <I>файл</I> ...
|
||
<BR>
|
||
|
||
<B>man</B> <B>-w</B>|<B>-W</B> [<I>параметры man</I>] <I>страница</I> ...
|
||
<A NAME="lbAD"> </A>
|
||
<H2>ОПИСАНИЕ</H2>
|
||
|
||
<B>man</B> — это пейджер справочных страниц системы. Каждый параметр
|
||
<I>страница</I>, переданный <B>man</B>, обычно является названием программы,
|
||
утилиты или функции. По каждому из этих параметров выполняется поиск и вывод
|
||
связанной с ним <I>справочной страницы</I>. Если указан параметр <I>раздел</I>, то
|
||
это заставляет <B>man</B> выполнять поиск только в этом справочном
|
||
<I>разделе</I>. Действием по умолчанию является поиск во всех доступных
|
||
<I>разделах</I> в заранее определённом порядке (смотрите <B>DEFAULTS</B>) и показ
|
||
только первой найденной <I>страницы</I>, даже если существуют <I>страницы</I> в
|
||
нескольких <I>разделах</I>.
|
||
<P>
|
||
В таблице ниже показаны номера справочных <I>разделов</I> и описание их
|
||
содержимого.
|
||
<P>
|
||
<TABLE>
|
||
<TR VALIGN=top><TD>1</TD><TD>
|
||
Исполняемые программы или команды оболочки (shell)
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>2</TD><TD>
|
||
Системные вызовы (функции, предоставляемые ядром)
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>3</TD><TD>
|
||
Библиотечные вызовы (функции, предоставляемые программными библиотеками)
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>4</TD><TD>
|
||
Специальные файлы (обычно находящиеся в каталоге <I>/dev/</I>)
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>5</TD><TD>
|
||
Форматы файлов и соглашения, например о <I>/etc/passwd</I>
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>6</TD><TD>
|
||
Игры
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>7</TD><TD>
|
||
Разное (включает пакеты макросов и соглашения),
|
||
например <B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7), <B><A HREF="/cgi-bin/man/man2html?7+groff">groff</A></B>(7)
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>8</TD><TD>
|
||
Команды администрирования системы (обычно, запускаемые только суперпользователем)
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>9</TD><TD>
|
||
Процедуры ядра [нестандартный раздел]
|
||
<BR></TD></TR>
|
||
</TABLE>
|
||
|
||
<P>
|
||
Справочная <I>страница</I> состоит из нескольких разделов.
|
||
<P>
|
||
Стандартные имена разделов: <B>НАЗВАНИЕ</B> (<B>NAME</B>), <B>СИНТАКСИС</B>
|
||
(<B>SYNOPSIS</B>), <B>НАСТРОЙКИ</B> (<B>CONFIGURATION</B>), <B>ОПИСАНИЕ</B>
|
||
(<B>DESCRIPTION</B>), <B>ПАРАМЕТРЫ</B> (<B>OPTIONS</B>), <B>КОД ВЫХОДА</B> (<B>EXIT STATUS</B>), <B>ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ</B> (<B>RETURN VALUE</B>), <B>ОШИБКИ</B>
|
||
(<B>ERRORS</B>), <B>ОКРУЖЕНИЕ</B> (<B>ENVIRONMENT</B>), <B>ФАЙЛЫ</B> (<B>FILES</B>), <B>ВЕРСИИ</B>
|
||
(<B>VERSIONS</B>), <B>СОГЛАСУЕТСЯ С</B> (<B>CONFORMING TO</B>), <B>ЗАМЕЧАНИЯ</B>
|
||
(<B>NOTES</B>), <B>ОШИБКИ</B> (<B>BUGS</B>), <B>ПРИМЕР</B> (<B>EXAMPLE</B>), <B>АВТОРЫ</B>
|
||
(<B>AUTHORS</B>) и <B>СМОТРИТЕ ТАКЖЕ</B> (<B>SEE ALSO</B>).
|
||
<P>
|
||
В разделе <B>СИНТАКСИС</B> используются следующие соглашения (которые также
|
||
могут быть использованы в качестве основы для других разделов).
|
||
<P>
|
||
<TABLE>
|
||
<TR VALIGN=top><TD><B>текст жирным шрифтом</B></TD><TD>
|
||
набирать точно как показано.
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD><I>текст курсивным шрифтом</I></TD><TD>
|
||
заменить соответствующим значением.
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>[<B>-abc</B>]</TD><TD>
|
||
любой или все параметры внутри [ ] необязательны.
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD><B>-a</B>|<B>-b</B></TD><TD>
|
||
параметры, разделённые |, не могут указываться одновременно.
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD><I>параметр</I> ...</TD><TD>
|
||
повторяющийся <I>параметр</I>.
|
||
<BR></TD></TR>
|
||
<TR VALIGN=top><TD>[<I>выражение</I>] ...</TD><TD>
|
||
всё <I>выражение</I> внутри [ ] может вводиться несколько раз.
|
||
<BR></TD></TR>
|
||
</TABLE>
|
||
|
||
<P>
|
||
Точная отрисовка может отличаться на разных устройствах вывода. Например,
|
||
man, обычно, не способна вывести курсив в терминале, и вместо него выведет
|
||
текст подчёркнутым или цветным.
|
||
<P>
|
||
При объяснении команды или функции должен применяться шаблон, который точно
|
||
описывает все возможные варианты вызова. В некоторых случаях рекомендуется
|
||
показать несколько уникальных вызовов, как показано в разделе <B>СИНТАКСИС</B>
|
||
этой справочной страницы.
|
||
<A NAME="lbAE"> </A>
|
||
<H2>ПРИМЕРЫ</H2>
|
||
|
||
<DL COMPACT>
|
||
<DT id="1"><B>man</B><I> ls</I><DD>
|
||
Показать справочную страницу для <I>параметра</I> (программы) <I>ls</I>.
|
||
<DT id="2"><B>man</B> <I>man</I>.<I>7</I><DD>
|
||
Показать справочную страницу пакета макросов <I>man</I> из раздела <I>7</I> (аналог
|
||
команды "<B>man</B> <I>7 man</I>").
|
||
<DT id="3"><B>man '</B><I>man</I>(<I>7</I>)'<DD>
|
||
Показать справочную страницу пакета макросов <I>man</I> из раздела <I>7</I> (аналог
|
||
команды "<B>man</B> <I>7 man</I>"; она удобнее для копирования и вставки
|
||
перекрёстных ссылок в справочные страницы; заметим, что скобки нужно
|
||
защищать кавычками из-за оболочки).
|
||
<DT id="4"><B>man -a</B><I> intro</I><DD>
|
||
Показать подряд все доступные справочные страницы по <I>intro</I>. В перерыве
|
||
между показами можно пропустить следующую справочную страницу или закончить
|
||
просмотр.
|
||
<DT id="5"><B>man -t </B><I>bash </I>|<I> lpr -Pps</I><DD>
|
||
Отформатировать справочную страницу для <I>bash</I> в формат по умолчанию
|
||
<B>troff</B> или <B>groff</B> и передать её по каналу в принтер с именем
|
||
<I>ps</I>. Обычно, форматом вывода <B>groff</B> по умолчанию является PostScript. По
|
||
команде <B>man --help</B> можно посмотреть какой процессор привязан к
|
||
параметру <B>-t</B>.
|
||
<DT id="6"><B>man -l -T</B><I>dvi ./foo.1x.gz</I><B> > </B><I>./foo.1x.dvi</I><DD>
|
||
Эта команда расжимает и форматирует справочную страницу в формате nroff
|
||
<I>./foo.1x.gz</I> в файл в формате <B>независимом от устройства
|
||
(dvi)</B>. Перенаправление вывода необходимо, так как при параметре <B>-T</B> вывод
|
||
направляется напрямую на <B>стандартный вывод</B> без пейджера. Результат может
|
||
быть просмотрен с помощью, например, <B>xdvi</B> или преобразован в PostScript с
|
||
помощью, например, <B>dvips</B>.
|
||
<DT id="7"><B>man -k</B><I> printf</I><DD>
|
||
Искать в кратких описаниях и именах справочных страниц ключевое слово
|
||
<I>printf</I>, рассматриваемое как регулярное выражение. Показать любые
|
||
найденные совпадения. Эквивалентно вызову <B>apropos</B><I> printf</I><B>.</B>
|
||
<DT id="8"><B>man -f</B><I> smail</I><DD>
|
||
Искать справочные страницы, ссылающиеся на <I>smail</I> и показать краткое
|
||
описание любой найденной. Эквивалентно вызову <B>whatis</B><I> smail</I><B>.</B>
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>ОБЗОР</H2>
|
||
|
||
Многие параметры <B>man</B> предназначены для предоставления как можно большей
|
||
гибкости пользователю. Можно изменять путь поиска, порядок разделов,
|
||
выходной обработчик и другие характеристики и операции — всё это подробно
|
||
описано ниже.
|
||
<P>
|
||
В работе <B>man</B> могут использоваться различные переменные
|
||
окружения. Возможно задать любые параметры во «всеобъемлющей» переменной
|
||
$<B>MANOPT</B>, экранируя пробельные символы в значениях (с помощью обратной
|
||
косой черты). <B>man</B> разбирает $<B>MANOPT</B> перед началом анализа
|
||
параметров, переданных при вызове в командной строке. Все значения
|
||
параметров, указанные в командной строке, заменят значения своих аналогов из
|
||
переменной окружения. Для сброса всех параметров, установленных с помощью
|
||
$<B>MANOPT</B>, можно указать параметр <B>-D</B> в начале командной строки. Это
|
||
позволит man «забыть» о значениях, указанных в $<B>MANOPT</B>, хотя они всё
|
||
равно должны быть заданы правильно.
|
||
<P>
|
||
Обычно, справочные страницы хранятся в формате <B><A HREF="/cgi-bin/man/man2html?1+nroff">nroff</A></B>(1) в каталоге
|
||
<I>/usr/share/man</I>. В некоторых установках для повышения производительности
|
||
также могут существовать заранее отформатированные <I>страницы cat</I>. Место
|
||
хранения этих файлов описано в <B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5).
|
||
<P>
|
||
Данный пакет обеспечивает поддержку справочных страниц на нескольких языках
|
||
(через <I>локаль</I>). Если система не настраивает её автоматически, то вам
|
||
необходимо присвоить переменной $<B>LC_MESSAGES</B>, $<B>LANG</B> или другой
|
||
переменной окружения (зависит от системы) значение локали предпочитаемого
|
||
языка, обычно задаваемое в формате <B>POSIX</B>:
|
||
<P>
|
||
|
||
|
||
|
||
<<I>язык</I>>[<B>_</B><<I>территория</I>>[<B>.</B><<I>кодировка</I>>[<B>,</B><<I>версия</I>>]]]
|
||
<P>
|
||
Если запрашиваемая страница доступна для вашей <I>локали</I>, то она будет
|
||
показана вместо стандартной (обычно, на американском английском) страницы.
|
||
<P>
|
||
Если вы обнаружили, что этот пакет не переведён ваш язык и вы хотите сделать
|
||
это, то свяжитесь с сопровождающим, который скоординирует данную работу.
|
||
<P>
|
||
Отдельные справочные страницы пишутся и поддерживаются сопровождающими
|
||
программы, функции или другой части, которую они описывают, и не включены в
|
||
этот пакет. Если вы обнаружите отсутствие или некорректность справочной
|
||
страницы, сообщите сопровождающим конкретного пакета.
|
||
<P>
|
||
О других возможностях и расширениях, доступных в этом пейджере справочных
|
||
страниц, читайте в описаниях из этого пакета.
|
||
<A NAME="lbAG"> </A>
|
||
<H2>ЗНАЧЕНИЯ ПО УМОЛЧАНИЮ</H2>
|
||
|
||
Порядок поиска по разделам можно изменить через переменную окружения
|
||
$<B>MANSECT</B> или директиву <B>SECTION</B> в <I>/etc/manpath.config</I>. Значение по
|
||
умолчанию следующее:
|
||
<P>
|
||
<DL COMPACT><DT id="9"><DD>
|
||
1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7
|
||
</DL>
|
||
|
||
<P>
|
||
Отформатированная справочная страница отображается <I>пейджером</I>. Его можно
|
||
задать несколькими способами, в противном случае будет использовано значение
|
||
по умолчанию (смотрите описание параметра <B>-P</B>).
|
||
<P>
|
||
Фильтры можно указывать разными способами. Во-первых, обрабатывается
|
||
значение параметра <B>-p</B> или переменная окружения $<B>MANROFFSEQ</B>. Если <B>-p</B>
|
||
не указывалась и переменная окружения не установлена, то в поисках строки
|
||
препроцессора анализируется первая строка nroff файла. Чтобы указывать
|
||
строку препроцессора правильно, первая строка должна быть в формате
|
||
<P>
|
||
<B>'\"</B> <<B>строка</B>>
|
||
<P>
|
||
где <B>строка</B> может содержать комбинацию букв, описанных в параметре <B>-p</B>
|
||
ниже.
|
||
<P>
|
||
Если информация о фильтре нигде не указана, то используется набор по
|
||
умолчанию.
|
||
<P>
|
||
|
||
Конвейер форматирования создаётся из фильтров и основной программы
|
||
форматирования (<B>nroff</B> или [<B>tg</B>]<B>roff</B> с параметром <B>-t</B>) и
|
||
выполняется. Или же, если существует исполняемая программа <I>mandb_nfmt</I>
|
||
(или <I>mandb_tfmt</I> с параметром <B>-t</B>) в корне дерева справочных страниц, то
|
||
выполняется именно она. Она получает файл с исходным текстом справочной
|
||
страницы, строку препроцессора, и, необязательно, устройство, указанное в
|
||
параметре <B>-T</B> или <B>-E</B>.
|
||
<A NAME="lbAH"> </A>
|
||
<H2>ПАРАМЕТРЫ</H2>
|
||
|
||
Параметры без значений, повторяющиеся в командной строки, $<B>MANOPT</B> или
|
||
обоих, не опасны. В случае с параметрами со значением, при каждом повторении
|
||
новое значение заменяет имеющееся.
|
||
<A NAME="lbAI"> </A>
|
||
<H3>Общие параметры</H3>
|
||
|
||
<DL COMPACT>
|
||
<DT id="10"><B>-C </B><I>файл</I>, <B>--config-file=</B><I>файл</I><DD>
|
||
Использовать указанный пользовательский файл настройки вместо значения по
|
||
умолчанию <I>~/.manpath</I>.
|
||
<DT id="11"><B>-d</B>, <B>--debug</B>
|
||
|
||
|
||
<DD>
|
||
Показывать отладочную информацию.
|
||
<DT id="12"><B>-D</B>, <B>--default</B>
|
||
|
||
|
||
<DD>
|
||
Этот параметр обычно вводится самым первым, и указывает <B>man</B>
|
||
активировать поведение по умолчанию. Он используется для сброса параметров,
|
||
которые могли быть установлены через переменную окружения $<B>MANOPT</B>. Любые
|
||
параметры, указанные после <B>-D</B>, будут действовать как обычно.
|
||
<DT id="13"><B>--warnings</B>[=<I>предупреждения/</I>]<DD>
|
||
Включить предупреждения от <I>groff</I>. Это может быть использовано для
|
||
проверки тривиальных ошибок в исходном тексте справочных
|
||
страниц. <I>Предупреждения</I> представляют собой список названий предупреждений
|
||
через запятую; если он не указан, то по умолчанию используется значение
|
||
«mac». Полный список доступных предупреждений можно найти в <B>info groff</B>,
|
||
раздел "Предупреждения".
|
||
</DL>
|
||
<A NAME="lbAJ"> </A>
|
||
<H3>Основные режимы работы</H3>
|
||
|
||
<DL COMPACT>
|
||
<DT id="14"><B>-f</B>, <B>--whatis</B>
|
||
|
||
|
||
<DD>
|
||
Эквивалентно работе <B>whatis</B>. Отображает краткое описание из справочной
|
||
страницы, если оно есть. Подробней смотрите <B><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></B>(1).
|
||
<DT id="15"><B>-k</B>, <B>--apropos</B>
|
||
|
||
|
||
<DD>
|
||
Эквивалентно работе <B>apropos</B>. Ищет в кратких описаниях справочных
|
||
страниц ключевые слова и показывает любые совпадения. Подробней смотрите
|
||
<B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1).
|
||
<DT id="16"><B>-K</B>, <B>--global-apropos</B>
|
||
|
||
|
||
<DD>
|
||
Поиск текста во всех справочных страницах. Используется простой поиск
|
||
перебором, что занимает определённое время; если можно, указывайте раздел
|
||
для сокращения числа страниц, в которых нужно искать. Термины поиска могут
|
||
быть простыми строками (по умолчанию), или регулярными выражениями, если
|
||
указан параметр <B>--regex</B>.
|
||
<DT id="17"><DD>
|
||
Заметим, что данный поиск выполняется по <I>исходному тексту</I> справочных
|
||
страниц, а не по отображаемому тексту, и поэтому может включать ложные
|
||
результаты, например, из-за комментариев в исходных файлах. Поиск по
|
||
отображаемому тексту выполнялся бы медленнее.
|
||
<DT id="18"><B>-l</B>, <B>--local-file</B>
|
||
|
||
|
||
<DD>
|
||
|
||
|
||
|
||
Включить «локальный» режим. Форматирует и показывает локальные справочные
|
||
файлы, а не ищет их в справочной коллекции системы. Каждый параметр
|
||
справочной страницы считается именем правильно отформатированного исходного
|
||
файла nroff. Cat файлы не создаются. Если в качестве одного из параметров
|
||
указан «-», то данные будут взяты из стандартного входного потока. Если этот
|
||
параметр не используется и man не может найти запрашиваемую страницу, то
|
||
перед тем как показать сообщение об ошибке, будет предпринята попытка
|
||
работать в локальном режиме, используя указанное имя в качестве имени файла
|
||
для поиска.
|
||
<DT id="19"><B>-w</B>, <B>--where</B>, <B>--path</B>, <B>--location</B>
|
||
|
||
|
||
<DD>
|
||
Не выводить содержимое справочной страницы, а показать место нахождения
|
||
исходного файла nroff, который был бы отформатирован. Если также указан
|
||
параметр <B>-a</B>, то вывести расположения всех исходных файлов, которые
|
||
подпадают под критерии поиска.
|
||
<DT id="20"><B>-W</B>, <B>--where-cat</B>, <B>--location-cat</B>
|
||
|
||
|
||
<DD>
|
||
Не выводить содержимое справочной страницы, а показать место нахождения
|
||
отформатированного файла cat, который был бы показан. Если также указан
|
||
параметр <B>-a</B>, то вывести расположения всех отформатированных файлов,
|
||
которые подпадают под критерии поиска.
|
||
<DT id="21"><DD>
|
||
Если указаны параметры <B>-w</B> и <B>-W</B>, и вывести исходный файл и файл cat,
|
||
разделив их пробелом. Если указаны сразу <B>-w</B>, <B>-W</B> и <B>-a</B>, то сделать
|
||
это для каждого возможного совпадения.
|
||
<DT id="22"><B>-c</B>, <B>--catman</B>
|
||
|
||
|
||
<DD>
|
||
Этот параметр не для обычного использования, и должен использоваться только
|
||
программой <B>catman</B>.
|
||
<DT id="23"><B>-R </B><I>кодировка</I>, <B>--recode</B>=<I>кодировка</I><DD>
|
||
Вместо обычного форматирования справочной страницы можно преобразовать
|
||
исходный текст в заданную <I>кодировку</I>. Если вам уже известна кодировка
|
||
исходного файла, то вы можете также использовать непосредственно
|
||
<B><A HREF="/cgi-bin/man/man2html?1+manconv">manconv</A></B>(1). Однако, этот параметр позволяет преобразовывать несколько
|
||
справочных страниц в одну кодировку без явного указания кодировки каждой
|
||
страницы, предполагая, что они уже установлены в структуру, подобную
|
||
иерархии справочных страниц.
|
||
<DT id="24"><DD>
|
||
Попробуйте использовать <B><A HREF="/cgi-bin/man/man2html?1+man-recode">man-recode</A></B>(1) вместо преобразования множества
|
||
справочных страниц, так как его интерфейс разработан для группового
|
||
преобразования и может выполнить эту задачу намного быстрее.
|
||
</DL>
|
||
<A NAME="lbAK"> </A>
|
||
<H3>Поиск справочных страниц</H3>
|
||
|
||
<DL COMPACT>
|
||
<DT id="25"><B>-L </B><I>локаль</I>, <B>--locale=</B><I>локаль</I><DD>
|
||
<B>man</B>, обычно, определяет текущую локаль с помощью вызова C-функции
|
||
<B><A HREF="/cgi-bin/man/man2html?3+setlocale">setlocale</A></B>(3), которая исследует различные переменные окружения, возможно
|
||
$<B>LC_MESSAGES</B> и $<B>LANG</B>. Для временной подмены полученного значения,
|
||
используйте этот параметр, задающий <I>локаль</I> только в
|
||
<B>man</B>. Заметим, что это влияет только непосредственно на поиск
|
||
страниц. Вывод сообщений программы, например справки, всегда будет
|
||
выполняться для изначально определённой локали.
|
||
<DT id="26"><B>-m</B> <I>система</I>[,...], <B>--systems=</B><I>система</I>[,...]<DD>
|
||
Если система имеет доступ к справочным страницам других операционных систем,
|
||
то к ним можно обратиться с помощью этого параметра. Чтобы найти справочную
|
||
страницу из коллекции страниц для операционной системы NewOS, укажите <B>-m</B>
|
||
<B>NewOS</B>.
|
||
<P>
|
||
В значении <I>система</I> может указать несколько имён операционных систем через
|
||
запятую. Чтобы включить поиск по справочным страницам родной операционной
|
||
системы, добавьте системное имя <B>man</B> в это значение. Этот параметр
|
||
заменяет значение переменной окружения $<B>SYSTEM</B>.
|
||
<DT id="27"><B>-M </B><I>путь</I>, <B>--manpath=</B><I>путь</I><DD>
|
||
Задать альтернативный manpath для работы. По умолчанию, для определения пути
|
||
поиска <B>man</B> использует <B>manpath</B>, указанный в исходном коде
|
||
программы. Этот параметр заменяет значение переменной окружения $<B>MANPATH</B>
|
||
и выключает действие параметра <B>-m</B>.
|
||
<P>
|
||
Задаваемый в качестве manpath путь должен быть корнем иерархии справочных
|
||
страниц, разделённой на разделы, описанных в справочной странице по man-db
|
||
(в разделе "Система справочных страниц"). Для просмотра справочных страниц
|
||
вне этих иерархий, используйте параметр <B>-l</B>.
|
||
<DT id="28"><B>-S</B> <I>список/</I>, <B>-s</B> <I>список/</I>, <B>--sections=</B><I>список/</I><DD>
|
||
Задаваемый <I>список</I> разделов, перечисляемых через запятую, используется для
|
||
определения разделов руководства поиска и их порядка. Этот параметр заменяет
|
||
значение переменной окружения $<B>MANSECT</B> (параметр <B>-s</B> введён для
|
||
совместимости с System V).
|
||
<DT id="29"><B>-e </B><I>доп.расширение</I>, <B>--extension=</B><I>доп.расширение</I><DD>
|
||
Некоторые системы включают большое число пакетов справочных страниц,
|
||
например таких, которые поставляются с пакетом <B>Tcl</B>, в главную иерархию
|
||
справочных страниц. Для решения проблемы появления двух справочных страниц с
|
||
одинаковым именем, например, <B><A HREF="/cgi-bin/man/man2html?3+exit">exit</A></B>(3), все страницы <B>Tcl</B>, обычно,
|
||
помещаются в раздел <B>l</B>. Но для страниц такого типа уже определён
|
||
правильный раздел (3). Теперь возможно помещать страницы в правильный
|
||
раздел, и назначать им специальное «расширение», в данном случае,
|
||
<B>exit</B>(3tcl). Обычно, <B>man</B> показывает <B><A HREF="/cgi-bin/man/man2html?3+exit">exit</A></B>(3), а не
|
||
<B>exit</B>(3tcl). Чтобы преодолеть это и не запоминать в каком разделе лежит
|
||
определённая страница, теперь возможно передать <B>man</B> строку
|
||
<I>доп.расширения</I>, указывающую какому пакету должна принадлежать
|
||
страница. Возвращаясь к примеру выше, укажите параметр <B>-e tcl</B> для
|
||
<B>man</B>, чтобы ограничить поиск только страницами с расширением <B>*tcl</B>.
|
||
<DT id="30"><B>-i</B>, <B>--ignore-case</B>
|
||
|
||
|
||
<DD>
|
||
Игнорировать регистр при поиске справочных страниц. Включено по умолчанию.
|
||
<DT id="31"><B>-I</B>, <B>--match-case</B>
|
||
|
||
|
||
<DD>
|
||
Искать справочные страницы с учётом регистра символов.
|
||
<DT id="32"><B>--regex</B>
|
||
|
||
|
||
<DD>
|
||
Показывает все страницы, у которых какая-то часть в имени или в описании
|
||
совпадает с параметром <I>страница</I>, заданным в виде регулярного выражения,
|
||
также как <B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1). Так как, обычно, нет разумного способа определить
|
||
"лучшую" страницу при поиске по регулярному выражению, то этот параметр
|
||
подразумевает <B>-a</B>.
|
||
<DT id="33"><B>--wildcard</B>
|
||
|
||
|
||
<DD>
|
||
Показывает все страницы, у которых какая-то часть в имени или в описании
|
||
совпадает с параметром <I>страница</I>, заданным в виде групповых символов,
|
||
также как в <B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1) <B>--wildcard</B>. Значение <I>страница</I> должно
|
||
полностью совпадать с именем или описанием, или совпадать по границе слов в
|
||
описании. Так как, обычно, нет разумного способа определить "лучшую"
|
||
страницу при поиске по регулярному выражению, то этот параметр подразумевает
|
||
<B>-a</B>.
|
||
<DT id="34"><B>--names-only</B>
|
||
|
||
|
||
<DD>
|
||
Если указан параметр <B>--regex</B> или <B>--wildcard</B>, то совпадения ищутся
|
||
только в именах страниц, а не в описании страницы, как в
|
||
<B><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></B>(1). Иначе, этого не происходит.
|
||
<DT id="35"><B>-a</B>, <B>--all</B>
|
||
|
||
|
||
<DD>
|
||
По умолчанию, <B>man</B> завершает работу после показа наиболее подходящей
|
||
найденной справочной страницы. Этот параметр заставляет <B>man</B> показать
|
||
все справочные страницы с именами, которые удовлетворяют критериям поиска.
|
||
<DT id="36"><B>-u</B>, <B>--update</B>
|
||
|
||
|
||
<DD>
|
||
Данный параметр заставляет <B>man</B> обновить свои кэши базы данные
|
||
установленных справочных страниц. Это требуется очень редко и для этого,
|
||
обычно, лучше запускать <B><A HREF="/cgi-bin/man/man2html?8+mandb">mandb</A></B>(8).
|
||
<DT id="37"><B>--no-subpages</B>
|
||
|
||
|
||
<DD>
|
||
По умолчанию, <B>man</B> пытается интерпретировать пары имён справочных
|
||
страниц, указанных в командной строке, как единое имя справочной страницы,
|
||
содержащее символ переноса или подчёркивания. Это поддерживает общую систему
|
||
программ, которые имеют несколько подкоманд, позволяя для каждой из них
|
||
предоставлять справочные страницы используя синтаксис, похожий на вызов
|
||
самих подкоманд. Например:
|
||
<P>
|
||
<PRE>
|
||
$ man -aw git diff /usr/share/man/man1/git-diff.1.gz</PRE>
|
||
|
||
<P>
|
||
Чтобы выключить такое поведение, укажите параметр <B>--no-subpages</B>.
|
||
<P>
|
||
<PRE>
|
||
$ man -aw --no-subpages git diff /usr/share/man/man1/git.1.gz /usr/share/man/man3/Git.3pm.gz /usr/share/man/man1/diff.1.gz</PRE>
|
||
|
||
</DL>
|
||
<A NAME="lbAL"> </A>
|
||
<H3>Контролирование форматированного вывода</H3>
|
||
|
||
<DL COMPACT>
|
||
<DT id="38"><B>-P </B><I>пейджер</I>, <B>--pager=</B><I>пейджер</I><DD>
|
||
Указывает, какой пейджер использовать для вывода. По умолчанию, <B>man</B>
|
||
использует <B>pager</B> и применяет <B>cat</B>, если <B>pager</B> не найден или не
|
||
является исполняемым файлом. Этот параметр заменяет значение переменной
|
||
окружения $<B>MANPAGER</B> которая, в свою очередь, заменяет значение переменной
|
||
окружения $<B>PAGER</B>. Не используется вместе с <B>-f</B> или <B>-k</B>.
|
||
<P>
|
||
Значением может быть просто имя команды или команды с параметрами, можно
|
||
использовать экранирование интерпретатора команд (обратные слэши, одиночные
|
||
кавычки или двойные кавычки). Нельзя объединять несколько команд каналами;
|
||
если эту нужно, создайте сценарий-обёртку, который получает файл для показа
|
||
в виде параметра или со стандартного ввода.
|
||
<DT id="39"><B>-r </B><I>приглашение</I>, <B>--prompt=</B><I>приглашение</I><DD>
|
||
Если в качестве пейджера используется новая версия <B>less</B>, то <B>man</B>
|
||
будет пытаться установить ей формат приглашения и некоторые значимые
|
||
параметры. По умолчанию приглашение выглядит как
|
||
<P>
|
||
<B> Manual page</B><I> имя</I><B>(</B><I>раздел</I><B>)</B><B> line</B><I> x</I>
|
||
<P>
|
||
|
||
|
||
|
||
|
||
где <I>имя</I> это имя справочной страницы, <I>раздел</I> — раздел, в котором она
|
||
была найдена и <I>x</I> — номер текущей строки. Приглашение устанавливается с
|
||
помощью переменной окружения $<B>LESS</B>.
|
||
<P>
|
||
|
||
|
||
|
||
|
||
Данное значение по умолчанию можно изменить с помощью параметра
|
||
<B>-r</B>. Значение параметра может содержать текст <B>$MAN_PN</B>, вместо которого
|
||
подставляется имя текущей справочной страницы и её название раздела,
|
||
окружённое «(» и «)». Строка, используемая для создания приглашения по
|
||
умолчанию, могла бы выглядеть как
|
||
<P>
|
||
<B>\ Справочная\ страница\ \$MAN_PN\ ?ltстрока\ %lt?L/%L.:</B>
|
||
<BR>
|
||
|
||
<B>byte\ %bB?s/%s..?\ (ВСЕ):?pB\ %pB\\%..</B>
|
||
<BR>
|
||
|
||
<B>(h — справка, q — выход)</B>
|
||
<P>
|
||
Здесь она разделена на три строки только для повышения читаемости. Описание
|
||
её составных частей смотрите в справочной странице <B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1). Строка
|
||
приглашения сначала обрабатывается оболочкой командной строки. Все двойные
|
||
кавычки, обратные кавычки и обратные косые черты в приглашении должны
|
||
предваряться обратными косыми чертами для экранирования. Строка приглашения
|
||
может заканчиваться экранированным $, за которым можно указать другие
|
||
параметры less. По умолчанию, <B>man</B> указывает параметры <B>-ix8</B>.
|
||
<P>
|
||
Переменная окружения $<B>MANLESS</B>, описанная ниже, может использоваться для
|
||
назначения строки приглашения по умолчанию, если это не задано в командной
|
||
строке.
|
||
<DT id="40"><B>-7</B>, <B>--ascii</B>
|
||
|
||
|
||
<DD>
|
||
При просмотре справочной страницы в изначальной кодировке <I><A HREF="/cgi-bin/man/man2html?7+ascii">ascii</A></I>(7) на
|
||
7-битном терминале или эмуляторе терминала при использовании описания
|
||
устройства <I><A HREF="/cgi-bin/man/man2html?7+latin1">latin1</A></I>(7) с <B>GNU</B> <B>nroff</B> некоторые символы могут
|
||
неправильно отображаться . Этот параметр позволяет справочным страницам в
|
||
изначальной <I>ascii</I> отображаться в <I>ascii</I>, используя устройство
|
||
<I>latin1</I>. Любой <I>latin1</I> текст не будет транслироваться. Следующая таблица
|
||
показывает выполняемые трансляции: некоторые её части могут отображаться
|
||
правильно только при использовании <B>GNU</B> <B>nroff</B> устройства <I><A HREF="/cgi-bin/man/man2html?7+latin1">latin1</A></I>(7).
|
||
<P>
|
||
|
||
|
||
|
||
|
||
<TABLE>
|
||
<TR VALIGN=top><TD>Описание</TD><TD ALIGN=center>Восьмеричный код</TD><TD ALIGN=center>latin1</TD><TD ALIGN=center>ascii<BR></TD></TR>
|
||
<TR VALIGN=top><TD COLSPAN=4><HR></TD></TR>
|
||
<TR VALIGN=top><TD>
|
||
длинный перенос
|
||
</TD><TD ALIGN=center>255</TD><TD ALIGN=center></TD><TD ALIGN=center>-<BR></TD></TR>
|
||
<TR VALIGN=top><TD>
|
||
bullet (точка в центре)
|
||
</TD><TD ALIGN=center>267</TD><TD ALIGN=center>•</TD><TD ALIGN=center>o<BR></TD></TR>
|
||
<TR VALIGN=top><TD>
|
||
значок ударения
|
||
</TD><TD ALIGN=center>264</TD><TD ALIGN=center>´</TD><TD ALIGN=center>'<BR></TD></TR>
|
||
<TR VALIGN=top><TD>
|
||
знак ударения
|
||
</TD><TD ALIGN=center>327</TD><TD ALIGN=center>×</TD><TD ALIGN=center>x<BR></TD></TR>
|
||
</TABLE>
|
||
|
||
|
||
<P>
|
||
Если колонка <I>latin1</I> отображается правильно, то ваш терминал может быть
|
||
настроен для отображения символов <I>latin1</I> и этот параметр ненужен. Если
|
||
колонки <I>latin1</I> и <I>ascii</I> одинаковы, то вы читаете эту страницу с помощью
|
||
данного параметра, или <B>man</B> не отформатировал страницу с помощью
|
||
описания устройства <I>latin1</I>. Если колонка <I>latin1</I> отсутствует или
|
||
повреждена, то вам может потребоваться просматривать справочные страницы с
|
||
помощью этого параметра.
|
||
<P>
|
||
Этот параметр игнорируется при использовании параметров <B>-t</B>, <B>-H</B>, <B>-T</B>
|
||
или <B>-Z</B>, и может быть бесполезен для <B>nroff</B>, если он не от <B>GNU</B>.
|
||
<DT id="41"><B>-E </B><I>кодировка</I>, <B>--encoding</B>=<I>кодировка</I><DD>
|
||
Сгенерировать вывод в символьной кодировке, отличной от используемой по
|
||
умолчанию. Кроме реальной символьной кодировки, типа <B>UTF-8</B>, для обратной
|
||
совместимости в <I>кодировке</I> можно указывать устройство <B>nroff</B>, например,
|
||
<B>ascii</B>, <B>latin1</B> или <B>utf8</B>.
|
||
<DT id="42"><B>--no-hyphenation</B>, <B>--nh</B>
|
||
|
||
|
||
<DD>
|
||
Обычно, <B>nroff</B> автоматически разбивает текст при окончании строки даже на
|
||
словах, у которых нет переносов, если это необходимо для размещения слов в
|
||
строке для избежания лишних пробелов. Этот параметр отключает автоматический
|
||
перенос; в результате перенос выполняется только для слов, в которых есть
|
||
символы переноса.
|
||
<P>
|
||
Если вы пишите справочную страницу и просто хотите отключить в <B>nroff</B>
|
||
перенос в словах в неподходящем месте, не используйте этот параметр, а
|
||
почитайте документацию к <B>nroff</B>; например, вы можете поместить "\%"
|
||
внутрь слова в место возможного разрыва, или поместить "\%" в начало слова,
|
||
что не даст его разорвать совсем.
|
||
<DT id="43"><B>--no-justification</B>, <B>--nj</B>
|
||
|
||
|
||
<DD>
|
||
Обычно, <B>nroff</B> автоматически выравнивает текст по обеим границам. Этот
|
||
параметр выключает полное выравнивание, оставляя выравнивание по левому
|
||
краю, получается так называемый текст "без выключки по правому краю".
|
||
<P>
|
||
Если вы пишите справочную страницу и просто хотите отключить в <B>nroff</B>
|
||
выравнивание в некоторых параграфах, не используйте этот параметр, а
|
||
почитайте документацию к <B>nroff</B>; например, вы можете использовать запросы
|
||
".na", ".nf", ".fi", и ".ad" для временного отключения выравнивания и
|
||
заполнения.
|
||
<DT id="44"><B>-p </B><I>строка</I>, <B>--preprocessor=</B><I>строка</I><DD>
|
||
Задать последовательность препроцессоров для запуска перед <B>nroff</B> или
|
||
<B>troff</B>/<B>groff</B>. Не во всех системах имеется полный набор
|
||
препроцессоров. Некоторые препроцессоры и буквы, используемые для их
|
||
обозначения: <B>eqn</B> (<B>e</B>), <B>grap</B> (<B>g</B>), <B>pic</B> (<B>p</B>), <B>tbl</B> (<B>t</B>),
|
||
<B>vgrind</B> (<B>v</B>), <B>refer</B> (<B>r</B>). Этот параметр заменяет значение
|
||
переменной окружения $<B>MANROFFSEQ</B>. <B>zsoelim</B> запускается всегда в
|
||
качестве первого очень быстрого препроцессора.
|
||
<DT id="45"><B>-t</B>, <B>--troff</B>
|
||
|
||
|
||
<DD>
|
||
Использовать <I>groff -mandoc</I> для форматирования справочной страницы и вывода в
|
||
стандартный выходной поток. Этот параметр не требуется вместе с <B>-H</B>, <B>-T</B>
|
||
или <B>-Z</B>.
|
||
<DT id="46"><B>-T</B>[<I>устройство/</I>], <B>--troff-device</B>[=<I>устройство/</I>]<DD>
|
||
Этот параметр используется для замены вывода <B>groff</B> (или, возможно,
|
||
<B>troff</B>) на более подходящий для устройства, отличного от используемого по
|
||
умолчанию. Подразумевается <B>-t</B>. Примеры (предоставляются с Groff-1.17)
|
||
включают <B>dvi</B>, <B>latin1</B>, <B>ps</B>, <B>utf8</B>, <B>X75</B> и <B>X100</B>.
|
||
<DT id="47"><B>-H</B>[<I>браузер/</I>], <B>--html</B>[=<I>браузер/</I>]<DD>
|
||
Этот параметр заставляет <B>groff</B> создавать HTML -страницу, и отображать её
|
||
в веб-браузере. Выбор браузера определяется необязательным значением
|
||
<I>браузер</I>, переменной окружения $<B>BROWSER</B>, или, если ничего не указано,
|
||
значением по умолчанию, установленным при компиляции программы (обычно
|
||
<B>lynx</B>). Этот параметр предполагает <B>-t</B>, и работает только с <B>GNU</B>
|
||
<B>troff</B>.
|
||
<DT id="48"><B>-X</B>[<I>dpi/</I>], <B>--gxditview</B>[=<I>dpi/</I>]<DD>
|
||
С этим параметром вывод <B>groff</B> осуществляет в графическое окно с помощью
|
||
программы <B>gxditview</B>. Значениями <I>dpi</I> (точек на дюйм) могут быть 75,
|
||
75-12, 100 или 100-12; по умолчанию 75; в вариантах с -12 в конце
|
||
используется базовый шрифт в 12 точек. Этот параметр подразумевает <B>-T</B> со
|
||
значениями устройств X75, X75-12, X100 и X100-12 соответственно.
|
||
<DT id="49"><B>-Z</B>, <B>--ditroff</B>
|
||
|
||
|
||
<DD>
|
||
<B>groff</B> запустит <B>troff</B>, а затем использует соответствующий постпроцессор
|
||
для создания результата, подходящего для выбранного устройства. Если
|
||
<I>groff -mandoc</I> совпадает с <B>groff</B>, то данный параметр передаётся <B>groff</B> и
|
||
использование постпроцессора отменяется. Подразумевает <B>-t</B>.
|
||
</DL>
|
||
<A NAME="lbAM"> </A>
|
||
<H3>Выдача справки</H3>
|
||
|
||
<DL COMPACT>
|
||
<DT id="50"><B>-?</B>, <B>--help</B>
|
||
|
||
|
||
<DD>
|
||
Показать справочное сообщение и закончить работу.
|
||
<DT id="51"><B>--usage</B>
|
||
|
||
|
||
<DD>
|
||
Показать короткое сообщение об использовании и завершить работу.
|
||
<DT id="52"><B>-V</B>, <B>--version</B>
|
||
|
||
|
||
<DD>
|
||
Показать информацию о версии.
|
||
</DL>
|
||
<A NAME="lbAN"> </A>
|
||
<H2>КОД ВЫХОДА</H2>
|
||
|
||
<DL COMPACT>
|
||
<DT id="53"><B>0</B>
|
||
|
||
|
||
<DD>
|
||
Успешное выполнение программы.
|
||
<DT id="54"><B>1</B>
|
||
|
||
|
||
<DD>
|
||
Была показана справка об использовании, произошла синтаксическая ошибка или
|
||
проблемы в файле настройки.
|
||
<DT id="55"><B>2</B>
|
||
|
||
|
||
<DD>
|
||
Ошибка при работе.
|
||
<DT id="56"><B>3</B>
|
||
|
||
|
||
<DD>
|
||
Дочерний процесс завершился с ненулевым кодом выхода.
|
||
<DT id="57"><B>16</B>
|
||
|
||
|
||
<DD>
|
||
По крайней мере одна из страниц/файлов/ключевых слов не существует или для
|
||
неё при поиске ничего не найдено.
|
||
</DL>
|
||
<A NAME="lbAO"> </A>
|
||
<H2>ОКРУЖЕНИЕ</H2>
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="58"><B>MANPATH</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANPATH</B>, то её значение
|
||
используется в качестве пути поиска справочных страниц.
|
||
<DT id="59"><B>MANROFFOPT</B>
|
||
|
||
|
||
<DD>
|
||
Всякий раз, когда <B>man</B> вызывает программу форматирования (<B>nroff</B>,
|
||
<B>troff</B> или <B>groff</B>) в её командную строку добавляется содержимое
|
||
$<B>MANROFFOPT</B>.
|
||
<DT id="60"><B>MANROFFSEQ</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANROFFSEQ</B>, то её значение
|
||
используется для определения набора препроцессоров для обработки каждой
|
||
справочной страницы. Список препроцессоров по умолчанию зависит от системы.
|
||
<DT id="61"><B>MANSECT</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANSECT</B>, то её значением является
|
||
список разделов, указанных через двоеточие, и она используется для задания
|
||
разделов справочных страниц, в которых будет производится поиск и в каком
|
||
порядке. Значением по умолчанию является «1 n l 8 3 2 3posix 3pm 3perl 3am 5 4 9 6 7», если оно не заменено
|
||
директивой <B>SECTION</B> в <I>/etc/manpath.config</I>.
|
||
<DT id="62"><B>MANPAGER</B>,<B> PAGER</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANPAGER</B> или $<B>PAGER</B>
|
||
($<B>MANPAGER</B> просматривается первой), то в ней задано имя программы для
|
||
отображения справочной страницы. По умолчанию, используется <B>pager</B> или
|
||
<B>cat</B>, если <B>pager</B> не найден или не является исполняемым файлом.
|
||
<P>
|
||
Значением может быть просто имя команды или команды с параметрами, можно
|
||
использовать экранирование интерпретатора команд (обратные слэши, одиночные
|
||
кавычки или двойные кавычки). Нельзя объединять несколько команд каналами;
|
||
если эту нужно, создайте сценарий-обёртку, который получает файл для показа
|
||
в виде параметра или со стандартного ввода.
|
||
<DT id="63"><B>MANLESS</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANLESS</B>, то её значение будет
|
||
использоваться по умолчанию как строка приглашения для пейджера <B>less</B>, как
|
||
если бы был указан параметр <B>-r</B> (так что любые появления текста <B>$MAN_PN</B>
|
||
будут как-то раскрыты). Например, если вы хотите установить строку
|
||
приглашения дословно в "my prompt string", то установите $<B>MANLESS</B>
|
||
равной '<B>-Psmy prompt string</B>'. Указанное значение параметра <B>-r</B>
|
||
замещает значение переменной окружения.
|
||
<DT id="64"><B>BROWSER</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>BROWSER</B>, то её значение
|
||
представляет собой список команд, разделяемых двоеточием; каждая из них
|
||
используется для попытки запуска веб-браузера для <B>man</B> <B>--html</B>. В каждой
|
||
команде <I>%s</I> заменяется именем файла, содержащим HTML результат от
|
||
<B>groff</B>, <I>%%</I> заменяется одним знаком процента (%), а <I>%c</I> заменяется
|
||
двоеточием (:).
|
||
<DT id="65"><B>SYSTEM</B>
|
||
|
||
|
||
<DD>
|
||
Установка значения переменной окружения $<B>SYSTEM</B> равносильна указанию
|
||
параметра <B>-m</B>.
|
||
<DT id="66"><B>MANOPT</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANOPT</B>, то она анализируется
|
||
раньше командной строки <B>man</B> и должна задаваться в том же
|
||
формате. Значения всех специальных переменных окружения <B>man</B> могут быть
|
||
заданы в параметрах командной строки, а включение в $<B>MANOPT</B> показывает,
|
||
что данный параметр скоро устареет. Обратите особое внимание на то, что все
|
||
пробелы, которые должны быть частью значения параметра, нужно экранировать.
|
||
<DT id="67"><B>MANWIDTH</B>
|
||
|
||
|
||
<DD>
|
||
Если установлена переменная окружения $<B>MANWIDTH</B>, то её значение
|
||
используется в качестве длины строки форматируемых справочных страниц. Если
|
||
она не установлена, то справочные страницы будут отформатированы по длине
|
||
строки текущего терминала (используется значение переменной $<B>COLUMNS</B>, и
|
||
вызов <B><A HREF="/cgi-bin/man/man2html?2+ioctl">ioctl</A></B>(2), если он доступен, или 80 символов, если ничего
|
||
недоступно). Cat страницы будут сохраняться на диск только, если может быть
|
||
использовано форматирование по умолчанию, то есть когда длина строки
|
||
терминала лежит в промежутке между 66 и 80 символами.
|
||
<DT id="68"><B>MAN_KEEP_FORMATTING</B>
|
||
|
||
|
||
<DD>
|
||
Обычно, если вывод не направляется на терминал (например, в файл или канал),
|
||
символы форматирования отбрасываются для облегчения чтения результата не
|
||
имея специальных инструментов. Однако, если переменная окружения
|
||
$<B>MAN_KEEP_FORMATTING</B> установлена в непустое значение, то символы
|
||
форматирования остаются. Это может быть полезно для оболочек вокруг
|
||
<B>man</B>, которые распознают символы форматирования.
|
||
<DT id="69"><B>MAN_KEEP_STDERR</B>
|
||
|
||
|
||
<DD>
|
||
Обычно, если вывод направляется на терминал (например, в пейджер), все
|
||
ошибки вывода команды, используемой для создания форматированного варианта
|
||
справочной страницы, отбрасываются во избежании порчи отображаемого
|
||
текста. Программы типа <B>groff</B> часто выводят относительно безобидные
|
||
сообщения об ошибках, например о печатных проблемах плохого выравнивания
|
||
вперемешку с информацией справочной страницы. Однако, некоторые пользователи
|
||
всё равно хотели бы их видеть, и поэтому, если установить переменную
|
||
окружения $<B>MAN_KEEP_STDERR</B> в непустое значение, вывод ошибок будет
|
||
производиться как обычно.
|
||
<DT id="70"><B>LANG</B>,<B> LC_MESSAGES</B>
|
||
|
||
|
||
<DD>
|
||
В зависимости от системы и реализации, одна или обе переменные $<B>LANG</B> и
|
||
$<B>LC_MESSAGES</B> будут просмотрены для определения текущей локали
|
||
сообщений. <B>man</B> будет отображать свои сообщения в этой локали (если они
|
||
для неё есть). Подробней смотрите в <B><A HREF="/cgi-bin/man/man2html?3+setlocale">setlocale</A></B>(3).
|
||
</DL>
|
||
<A NAME="lbAP"> </A>
|
||
<H2>ФАЙЛЫ</H2>
|
||
|
||
<DL COMPACT>
|
||
<DT id="71"><I>/etc/manpath.config</I>
|
||
|
||
|
||
<DD>
|
||
Файл настройки man-db.
|
||
<DT id="72"><I>/usr/share/man</I>
|
||
|
||
|
||
<DD>
|
||
Глобальная иерархия справочных страниц.
|
||
</DL>
|
||
<A NAME="lbAQ"> </A>
|
||
<H2>СМОТРИТЕ ТАКЖЕ</H2>
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+groff">groff</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+manpath">manpath</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+nroff">nroff</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+troff">troff</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?1+zsoelim">zsoelim</A></B>(1),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?5+manpath">manpath</A></B>(5),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?8+catman">catman</A></B>(8),
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?8+mandb">mandb</A></B>(8)
|
||
|
||
|
||
<P>
|
||
|
||
Документация на некоторые пакеты может быть доступна в других форматах,
|
||
например, <B><A HREF="/cgi-bin/man/man2html?1+info">info</A></B>(1) или HTML.
|
||
<A NAME="lbAR"> </A>
|
||
<H2>ИСТОРИЯ</H2>
|
||
|
||
1990, 1991 - изначально написана Джоном В. Итоном (John W. Eaton,
|
||
<A HREF="mailto:jwe@che.utexas.edu">jwe@che.utexas.edu</A>).
|
||
<P>
|
||
23 декабря 1992: Рик Фейт (Rik Faith, <A HREF="mailto:faith@cs.unc.edu">faith@cs.unc.edu</A>) исправил ошибки,
|
||
найденные Виллемом Касдорпом (Willem Kasdorp, <A HREF="mailto:wkasdo@nikhefk.nikef.nl">wkasdo@nikhefk.nikef.nl</A>).
|
||
<P>
|
||
30 апреля 1994 - 23 февраля 2000: Вильф (Wilf.
|
||
<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>) разрабатывал и сопровождал этот пакет с помощью
|
||
некоторых других людей.
|
||
<P>
|
||
30 октября 1996 - 30 марта 2001: Фабрицио Полако (Fabrizio Polacco,
|
||
<<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>> сопровождал и улучшал этот пакет для проекта
|
||
Debian с помощью всего сообщества.
|
||
<P>
|
||
31 марта 2001 - настоящие дни: Колин Уотсон (Colin Watson,
|
||
<<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>> занимается разработкой и сопровождением
|
||
man-db.
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="73"><A HREF="#lbAB">НАЗВАНИЕ</A><DD>
|
||
<DT id="74"><A HREF="#lbAC">СИНТАКСИС</A><DD>
|
||
<DT id="75"><A HREF="#lbAD">ОПИСАНИЕ</A><DD>
|
||
<DT id="76"><A HREF="#lbAE">ПРИМЕРЫ</A><DD>
|
||
<DT id="77"><A HREF="#lbAF">ОБЗОР</A><DD>
|
||
<DT id="78"><A HREF="#lbAG">ЗНАЧЕНИЯ ПО УМОЛЧАНИЮ</A><DD>
|
||
<DT id="79"><A HREF="#lbAH">ПАРАМЕТРЫ</A><DD>
|
||
<DL>
|
||
<DT id="80"><A HREF="#lbAI">Общие параметры</A><DD>
|
||
<DT id="81"><A HREF="#lbAJ">Основные режимы работы</A><DD>
|
||
<DT id="82"><A HREF="#lbAK">Поиск справочных страниц</A><DD>
|
||
<DT id="83"><A HREF="#lbAL">Контролирование форматированного вывода</A><DD>
|
||
<DT id="84"><A HREF="#lbAM">Выдача справки</A><DD>
|
||
</DL>
|
||
<DT id="85"><A HREF="#lbAN">КОД ВЫХОДА</A><DD>
|
||
<DT id="86"><A HREF="#lbAO">ОКРУЖЕНИЕ</A><DD>
|
||
<DT id="87"><A HREF="#lbAP">ФАЙЛЫ</A><DD>
|
||
<DT id="88"><A HREF="#lbAQ">СМОТРИТЕ ТАКЖЕ</A><DD>
|
||
<DT id="89"><A HREF="#lbAR">ИСТОРИЯ</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:06:22 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|