man-db-manpages 2.12.0-pre2 - en to ru translation catalogue (374 entries)

note: type: TH
en: Manual pager utils
ru: Утилиты просмотра справочных страниц

note: type: SH
en: NAME
ru: НАЗВАНИЕ

note: type: Plain text
en: %apropos% - search the manual page names and descriptions
ru: %apropos% - поиск в именах справочных страниц и кратких описаниях

note: type: SH
en: SYNOPSIS
ru: СИНТАКСИС

note: type: Plain text
en: B<%apropos%> [\|B<-dalv?V>\|] [\|B<-e>\||\|B<-w>\||\|B<-r>\|] [\|B<-s> I<list>\|] [\|B<-m> I<system>\|[\|,.\|.\|.\|]\|] [\|B<-M> I<path>\|] [\|B<-L> I<locale>\|] [\|B<-C> I<file>\|] I<keyword> \&.\|.\|.
ru: B<%apropos%> [\|B<-dalv?V>\|] [\|B<-e>\||\|B<-w>\||\|B<-r>\|] [\|B<-s> I<список>\|] [\|B<-m> I<система>\|[\|,.\|.\|.\|]\|] [\|B<-M> I<путь>\|] [\|B<-L> I<локаль>\|] [\|B<-C> I<файл>\|] I<ключевое слово> \&.\|.\|.

note: type: SH
en: DESCRIPTION
ru: ОПИСАНИЕ

note: type: Plain text
en: Each manual page has a short description available within it.  B<%apropos%> searches the descriptions for instances of I<keyword>.
ru: Внутри каждой справочной страницы есть краткое описание о чём эта страница. B<%apropos%> выполняет поиск I<ключевого слова> в этом описании.

note: type: Plain text
en: I<keyword> is usually a regular expression, as if (B<-r>)  was used, or may contain wildcards (B<-w>), or match the exact keyword (B<-e>).  Using these options, it may be necessary to quote the I<keyword> or escape (\e) the special characters to stop the shell from interpreting them.
ru: I<Ключевое слово> может представлять собой регулярное выражение (B<-r>), шаблон (B<-w>) или точное искомое ключевое слово (B<-e>). При использовании этих параметров может потребоваться указывать I<ключевое слово> в кавычках или экранировать (\e) специальные символы для того, чтобы избежать их интерпретации оболочкой командной строки.

note: type: Plain text
en: The standard matching rules allow matches to be made against the page name and word boundaries in the description.
ru: Стандартные правила поиска позволяют искать по названию страницы и границам слова в описании.

note: type: Plain text
en: The database searched by B<%apropos%> is updated by the B<%mandb%> program.  Depending on your installation, this may be run by a periodic cron job, or may need to be run manually after new manual pages have been installed.
ru: Используемая B<%apropos%> поисковая база данных обновляется программой B<%mandb%>. В зависимости от установки, она может запускаться как периодически выполняемое задание cron или вручную, после установки новых справочных страниц.

note: type: SH
en: OPTIONS
ru: ПАРАМЕТРЫ

note: type: Plain text
en: Print debugging information.
ru: Показывать отладочную информацию.

note: type: Plain text
en: Print verbose warning messages.
ru: Показывать подробные предупреждающие сообщения.

note: type: Plain text
en: Interpret each keyword as a regular expression.  This is the default behaviour.  Each keyword will be matched against the page names and the descriptions independently.  It can match any part of either.  The match is not limited to word boundaries.
ru: Рассматривать каждое ключевое слово как регулярное выражение. Является поведением по умолчанию. Для каждого ключевого слова будет выполнен независимый поиск в названиях страниц и описаниях. Для совпадения достаточно нахождения в одном из этих мест. Сравнение не ограничивается границами слова.

note: type: Plain text
en: Interpret each keyword as a pattern containing shell style wildcards.  Each keyword will be matched against the page names and the descriptions independently.  If B<--exact> is also used, a match will only be found if an expanded keyword matches an entire description or page name.  Otherwise the keyword is also allowed to match on word boundaries in the description.
ru: Рассматривать каждое ключевое слово как шаблон с символами подстановки в стиле оболочки командной строки. Для каждого ключевого слова будет выполнен независимый поиск в названиях страниц и описаниях. Если также указан параметр B<--exact>, то совпадением будет считаться только полное равенство раскрытого ключевого слова со всем описанием или названием страницы. Иначе сравнение ограничивается границами слова в описании.

note: type: Plain text
en: Each keyword will be exactly matched against the page names and the descriptions.
ru: Искать точное совпадение с названиями страниц и описаниями каждого ключевого слова.

note: type: Plain text
en: Only display items that match all the supplied keywords.  The default is to display items that match any keyword.
ru: Показывать страницы, в которых найдены все указанные ключевые слова. По умолчанию отображаются страницы, в которых есть хотя бы одно ключевое слово.

note: type: Plain text
en: Do not trim output to the terminal width.  Normally, output will be truncated to the terminal width to avoid ugly results from poorly-written B<NAME> sections.
ru: Не обрезать вывод по ширине терминала. Обычно, вывод обрезается по ширине терминала во избежание проблем с плохо оформленными разделами B<НАЗВАНИЕ>.

note: type: TP
en: B<-s> I<list\/>, B<--sections=>I<list\/>, B<--section=>I<list>
ru: B<-s> I<список\/>, B<--sections=>I<список\/>, B<--section=>I<список>

note: type: Plain text
en: Search only the given manual sections.  I<list> is a colon- or comma-separated list of sections.  If an entry in I<list> is a simple section, for example "3", then the displayed list of descriptions will include pages in sections "3", "3perl", "3x", and so on; while if an entry in I<list> has an extension, for example "3perl", then the list will only include pages in that exact part of the manual section.
ru: Искать только в заданном разделе справочных страниц. В I<списке> перечисляются разделы через двоеточие или запятую. Если в I<списке> указан только номер, например "3", то в выводимый список описаний войдут страницы из разделов "3", "3perl", "3x" и так далее; но если в I<списке> указано расширение, например "3perl", то будут показаны страницы только из раздела справочных страниц с этим расширением.

note: type: TP
en: B<-m> I<system>\|[\|,.\|.\|.\|]\|, B<--systems=>I<system>\|[\|,.\|.\|.\|]
ru: B<-m> I<система>\|[\|,.\|.\|.\|]\|, B<--systems=>I<система>\|[\|,.\|.\|.\|]

note: type: Plain text
en: If this system has access to other operating systems' manual page descriptions, they can be searched using this option.  To search NewOS's manual page descriptions, use the option B<-m> B<NewOS>.
ru: Если эта система имеет доступ к описаниям справочных страниц других операционных систем, то с помощью этого параметра среди них тоже может быть осуществлён поиск. Чтобы искать в описаниях справочных страниц по NewOS, укажите параметр B<-m> B<NewOS>.

note: type: Plain text
en: The I<system> specified can be a combination of comma-delimited operating system names.  To include a search of the native operating system's B<whatis> descriptions, include the system name B<man> in the argument string.  This option will override the $B<SYSTEM> environment variable.
ru: В значении I<системы> можно указать несколько названий систем, перечислив их через запятую. Чтобы включить поиск в B<whatis>-описаниях по родной операционной системе, добавьте в значение системное название B<man>. Этот параметр подменяет значение переменной окружения $B<SYSTEM>.

note: type: TP
en: B<-M\ >I<path>,\ B<--manpath=>I<path>
ru: B<-M\ >I<путь>,\ B<--manpath=>I<путь>

note: type: Plain text
en: Specify an alternate set of colon-delimited manual page hierarchies to search.  By default, B<%program%> uses the $B<MANPATH> environment variable, unless it is empty or unset, in which case it will determine an appropriate manpath based on your $B<PATH> environment variable.  This option overrides the contents of $B<MANPATH>.
ru: Задать альтернативный набор каталогов (через двоеточие) иерархии справочных страниц для поиска. По умолчанию, B<%program%> использует переменную окружения $B<MANPATH>, если она существует и не пуста, иначе соответствующий manpath определяется на основе переменной окружения $B<PATH>. Этот параметр подменяет значение переменной окружения $B<MANPATH>.

note: type: TP
en: B<-L\ >I<locale>,\ B<--locale=>I<locale>
ru: B<-L\ >I<локаль>,\ B<--locale=>I<локаль>

note: type: Plain text
en: B<%program%> will normally determine your current locale by a call to the C function B<setlocale>(3)  which interrogates various environment variables, possibly including $B<LC_MESSAGES> and $B<LANG>.  To temporarily override the determined value, use this option to supply a I<locale> string directly to B<%program%>.  Note that it will not take effect until the search for pages actually begins.  Output such as the help message will always be displayed in the initially determined locale.
ru: B<%program%>, обычно, определяет текущую локаль с помощью вызова C-функции B<setlocale>(3), которая исследует различные переменные окружения, возможно $B<LC_MESSAGES> и $B<LANG>. Для временной подмены полученного значения, используйте этот параметр, задающий I<локаль> только в B<%program%>. Заметим, что это влияет только непосредственно на поиск страниц. Вывод сообщений программы, например справки, всегда будет выполняться для изначально определённой локали.

note: type: TP
en: B<-C\ >I<file>,\ B<--config-file=>I<file>
ru: B<-C\ >I<файл>,\ B<--config-file=>I<файл>

note: type: Plain text
en: Use this user configuration file rather than the default of I<\(ti/.manpath>.
ru: Использовать указанный пользовательский файл настройки вместо значения по умолчанию I<\(ti/.manpath>.

note: type: Plain text
en: Print a help message and exit.
ru: Показать справочное сообщение и закончить работу.

note: type: Plain text
en: Print a short usage message and exit.
ru: Показать короткое сообщение об использовании и завершить работу.

note: type: Plain text
en: Display version information.
ru: Показать информацию о версии.

note: type: SH
en: EXIT STATUS
ru: КОД ВЫХОДА

note: type: Plain text
en: Successful program execution.
ru: Успешное выполнение программы.

note: type: Plain text
en: Usage, syntax or configuration file error.
ru: Была показана справка об использовании, произошла синтаксическая ошибка или проблемы в файле настройки.

note: type: Plain text
en: Operational error.
ru: Ошибка при работе.

note: type: Plain text
en: Nothing was found that matched the criteria specified.
ru: По запросу ничего не найдено.

note: type: SH
en: ENVIRONMENT
ru: ОКРУЖЕНИЕ

note: type: Plain text
en: If $B<SYSTEM> is set, it will have the same effect as if it had been specified as the argument to the B<-m> option.
ru: Установка значения переменной окружения $B<SYSTEM> равносильна указанию параметра B<-m>.

note: type: Plain text
en: If $B<MANPATH> is set, its value is interpreted as the colon-delimited manual page hierarchy search path to use.
ru: Если установлена переменная окружения $B<MANPATH>, то она рассматривается как набор каталогов (через двоеточие) иерархии справочных страниц для использования при поиске.

note: type: Plain text
en: See the B<SEARCH PATH> section of B<manpath>(5)  for the default behaviour and details of how this environment variable is handled.
ru: О том, как используется эта переменная окружения и поведение по умолчанию, смотрите раздел B<ПУТЬ ПОИСКА> в B<manpath>(5).

note: type: Plain text
en: If $B<MANWIDTH> is set, its value is used as the terminal width (see the B<--long> option).  If it is not set, the terminal width will be calculated using the value of $B<COLUMNS>, and B<ioctl>(2)  if available, or falling back to 80 characters if all else fails.
ru: Если установлена переменная окружения $B<MANWIDTH>, то её значение используется для определения ширины терминала (смотрите описание параметра B<--long>). Если она не установлена, то ширина терминала вычисляется из значения переменной окружения $B<COLUMNS> и, если доступен, вызова B<ioctl>(2) или устанавливается равной 80 символам, если определить значение не удалось.

note: type: Plain text
en: If $B<POSIXLY_CORRECT> is set, even to a null value, the default B<%apropos%> search will be as an extended regex (B<-r>).  Nowadays, this is the default behaviour anyway.
ru: Если установлена переменная окружения $B<POSIXLY_CORRECT>, даже имеющая пустое значение, то по умолчанию B<%apropos%> включает поиск по расширенным регулярным выражениям (B<-r>). В настоящее время, это всё равно является поведением по умолчанию.

note: type: SH
en: FILES
ru: ФАЙЛЫ

note: type: Plain text
en: A traditional global I<index> database cache.
ru: Традиционный кэш глобальной базы данных I<index>.

note: type: Plain text
en: An FHS compliant global I<index> database cache.
ru: Соответствующий FHS глобальный кэш базы данных I<index>.

note: type: Plain text
en: A traditional B<whatis> text database.
ru: Традиционная текстовая база данных B<whatis>.

note: type: SH
en: SEE ALSO
ru: СМОТРИТЕ ТАКЖЕ

note: type: SH
en: AUTHOR
ru: АВТОР

note: type: SH
en: BUGS
ru: ОШИБКИ

note: type: Plain text
en: lexgrog - parse header information in man pages
ru: lexgrog - анализирует заголовочную информацию справочных страниц

note: type: Plain text
en: B<lexgrog> [\|B<-m>\||\|B<-c>\|] [\|B<-dfw?V>\|] [\|B<-E> I<encoding>\|] I<file> \&.\|.\|.
ru: B<lexgrog> [\|B<-m>\||\|B<-c>\|] [\|B<-dfw?V>\|] [\|B<-E> I<кодировка>\|] I<файл> \&.\|.\|.

note: type: Plain text
en: B<lexgrog> is an implementation of the traditional \(lqgroff guess\(rq utility in B<lex>.  It reads the list of files on its command line as either man page source files or preformatted \(lqcat\(rq pages, and displays their name and description as used by B<apropos> and B<whatis>, the list of preprocessing filters required by the man page before it is passed to B<nroff> or B<troff>, or both.
ru: B<lexgrog> — это реализация традиционной \(lqgroff guess\(rq утилиты с помощью B<lex>. Она читает список файлов из командной строки, которые являются файлами исходников справочных страниц или уже отформированными (\(lqcat\(rq) страницами, и показывает их названия и описания, используемые B<apropos> и B<whatis>, список предварительных фильтров обработки, требуемый man страницей перед тем как она будет передана B<nroff> или B<troff>, или обеим программам.

note: type: Plain text
en: If its input is badly formatted, B<lexgrog> will print \(lqparse failed\(rq; this may be useful for external programs that need to check man pages for correctness.  If one of B<lexgrog>'s input files is \(lq-\(rq, it will read from standard input; if any input file is compressed, a decompressed version will be read automatically.
ru: Если входные данные неправильно отформатированы, B<lexgrog> выведет \(lqparse failed\(rq; это может оказаться полезным для внешних программ, которым нужно проверять правильность написания man страниц. Если в качестве одного из имён файлов B<lexgrog> передан символ \(lq-\(rq, то данные будут читаться из стандартного входного потока; если любой входной файл сжат, то будет автоматически читаться его расжатая версия.

note: type: Plain text
en: Parse input as man page source files.  This is the default if neither B<--man> nor B<--cat> is given.
ru: Анализировать входные данные как файлы исходников справочных страниц. Является действием по умолчанию, если не указан параметр B<--man> или B<--cat>.

note: type: Plain text
en: Parse input as preformatted man pages (\(lqcat pages\(rq).  B<--man> and B<--cat> may not be given simultaneously.
ru: Анализировать входные данные как уже отформатированные справочные страницы (\(lqcat страницы\(rq). B<--man> и B<--cat> не могут указываться одновременно.

note: type: Plain text
en: Display the name and description from the man page's header, as used by B<apropos> and B<whatis>.  This is the default if neither B<--whatis> nor B<--filters> is given.
ru: Показать название и описание из заголовка справочной страницы, используемого B<apropos> и B<whatis>. Является действием по умолчанию, если не указан параметр B<--whatis> или B<--filters>.

note: type: Plain text
en: Display the list of filters needed to preprocess the man page before formatting with B<nroff> or B<troff>.
ru: Показать список фильтров, необходимых для предварительной обработки справочной страницы перед форматированием с помощью B<nroff> или B<troff>.

note: type: TP
en: B<-E> I<encoding>, B<--encoding> I<encoding>
ru: B<-E> I<кодировка>, B<--encoding> I<кодировка>

note: type: Plain text
en: Override the guessed character set for the page to I<encoding>.
ru: Использовать I<кодировку> вместо предполагаемой кодировки символов страницы.

note: type: Plain text
en: Usage error.
ru: Ошибка использования.

note: type: Plain text
en: B<lexgrog> failed to parse one or more of its input files.
ru: B<lexgrog> не удалось разобрать один или более входных файлов.

note: type: SH
en: EXAMPLES
ru: ПРИМЕРЫ

note: type: SH
en: WHATIS PARSING
ru: ЧТО АНАЛИЗИРУЕТСЯ

note: type: Plain text
en: B<%mandb%> (which uses the same code as B<lexgrog>)  parses the B<NAME> section at the top of each manual page looking for names and descriptions of the features documented in each.  While the parser is quite tolerant, as it has to cope with a number of different forms that have historically been used, it may sometimes fail to extract the required information.
ru: B<%mandb%> (использует тот же код, что и B<lexgrog>) анализирует раздел B<NAME> (B<НАЗВАНИЕ>), расположенный в самом начале каждой справочной страницы, в поиске названий и описаний возможностей. Хотя анализатор допускает различные вариации и понимает много различных форматов, которые сложились за время использования, иногда он не может извлечь требуемую информацию.

note: type: Plain text
en: When using the traditional I<man> macro set, a correct B<NAME> section looks something like this:
ru: При использовании традиционных наборов макросов I<man>, правильно оформленный раздел B<NAME> выглядит так:

note: type: Plain text
en: \&.SH NAME
    foo \e- program to do something
ru: \&.SH NAME
    foo \e- программа, выполняющая что-то

note: type: Plain text
en: Some manual pagers require the \(oq\e-\(cq to be exactly as shown; B<%mandb%> is more tolerant, but for compatibility with other systems it is nevertheless a good idea to retain the backslash.
ru: Некоторые справочные пейджеры требуют \(oq\e-\(cq точно как показано; B<%mandb%> более терпим, но для совместимости с другими системами всё же лучше оставлять символ обратной косой черты.

note: type: Plain text
en: On the left-hand side, there may be several names, separated by commas.  Names containing whitespace will be ignored to avoid pathological behaviour on certain ill-formed B<NAME> sections.  The text on the right-hand side is free-form, and may be spread over multiple lines.  If several features with different descriptions are being documented in the same manual page, the following form is therefore used:
ru: Слева от черты могут быть несколько названий, разделённых через запятую. Названия с пробелами будут игнорироваться во избежании необычного поведения для определённо плохо оформленных разделов B<NAME>. У текста справа нет специального формата, и он может располагаться на нескольких строках. Если в одной справочной странице содержатся несколько свойств с различными описаниями, то используется следующая форма:

note: type: Plain text
en: \&.SH NAME
    foo, bar \e- programs to do something
    \&.br
    baz \e- program to do nothing
ru: \&.SH NAME
    foo, bar \e- программы, выполняющие что-то
    \&.br
    baz \e- программа ничего не делающая

note: type: Plain text
en: (A macro which starts a new paragraph, like B<.PP>, may be used instead of the break macro B<.br>.)
ru: (Вместо макроса разрыва B<.br> может использоваться макрос, начинающий новый параграф, типа B<.PP>.)

note: type: Plain text
en: When using the BSD-derived I<mdoc> macro set, a correct B<NAME> section looks something like this:
ru: Если используется BSD-производный набор макросов I<mdoc>, то правильно оформленный раздел B<NAME> выглядит так:

note: type: Plain text
en: \&.Sh NAME
    \&.Nm foo
    \&.Nd program to do something
ru: &.Sh NAME
    \&.Nm foo
    \&.Nd программа, выполняющая что-то

note: type: Plain text
en: There are several common reasons why whatis parsing fails.  Sometimes authors of manual pages replace \(oq.SH NAME\(cq with \(oq.SH MYPROGRAM\(cq, and then B<%mandb%> cannot find the section from which to extract the information it needs.  Sometimes authors include a NAME section, but place free-form text there rather than \(oqname \e- description\(cq.  However, any syntax resembling the above should be accepted.
ru: Есть несколько распространённых причин, по которым анализ может завершаться неудачно. Иногда авторы справочных страниц заменяют \(oq.SH NAME\(cq на \(oq.SH MYPROGRAM\(cq, и поэтому B<%mandb%> не может найти раздел, из которого нужно извлекать информацию. Иногда авторы включают раздел NAME, но размещают его в свободной форме, а не как положено \(oqназвание \e- описание\(cq. Однако любой синтаксис, приведённый выше, будет понят.

note: type: SH
en: NOTES
ru: ЗАМЕЧАНИЯ

note: type: Plain text
en: B<lexgrog> attempts to parse files containing .so requests, but will only be able to do so correctly if the files are properly installed in a manual page hierarchy.
ru: B<lexgrog> пытается проанализировать файлы, содержащие запросы .so, но сможет это сделать, если только файлы правильно установлены в иерархии справочных страниц.

note: type: Plain text
en: The code used by B<lexgrog> to scan man pages was written by:
ru: Авторы кода, используемого B<lexgrog> для сканирования справочных страниц:

note: type: Plain text
en: Colin Watson wrote the current incarnation of the command-line front-end, as well as this man page.
ru: Колин Ватсон (Colin Watson) написал текущий вариант для интерфейса командной строки, а также данную справочную страницу.

note: type: Plain text
en: %man% - an interface to the system reference manuals
ru: %man% - доступ к системным справочным страницам

note: The general command line The apropos command line type: Plain text
en: B<%man%> [\|I<man options>\|] [\|[\|I<section>\|] I<page>\ \|.\|.\|.\|]\ .\|.\|.\&
ru: B<%man%> [\|I<параметры man>\|] [\|[\|I<раздел>\|] I<страница>\ \|.\|.\|.\|]\ .\|.\|.\&

note: The --global-apropos command line type: Plain text
en: B<%man%> B<-k> [\|I<apropos options>\|] I<regexp> \&.\|.\|.\&
ru: B<%man%> B<-k> [\|I<параметры apropos>\|] I<регвыр> \&.\|.\|.\&

note: The whatis command line type: Plain text
en: B<%man%> B<-K> [\|I<man options>\|] [\|I<section>\|] I<term>\ .\|.\|.\&
ru: B<%man%> B<-K> [\|I<параметры man>\|] [\|I<раздел>\|] I<термин>\ .\|.\|.\&

note: The --local command line type: Plain text
en: B<%man%> B<-f> [\|I<whatis> I<options>\|] I<page> \&.\|.\|.\&
ru: B<%man%> B<-f> [\|I<whatis> I<параметры>\|] I<страница> \&.\|.\|.\&

note: The --where/--where-cat command line type: Plain text
en: B<%man%> B<-l> [\|I<man options>\|] I<file> \&.\|.\|.\&
ru: B<%man%> B<-l> [\|I<параметры man>\|] I<файл> \&.\|.\|.\&

note: type: Plain text
en: B<%man%> B<-w>\||\|B<-W> [\|I<man options>\|] I<page> \&.\|.\|.\&
ru: B<%man%> B<-w>\||\|B<-W> [\|I<параметры man>\|] I<страница> \&.\|.\|.\&

note: type: Plain text
en: B<%man%> is the system's manual pager.  Each I<page> argument given to B<%man%> is normally the name of a program, utility or function.  The I<manual page> associated with each of these arguments is then found and displayed.  A I<section>, if provided, will direct B<%man%> to look only in that I<section> of the manual.  The default action is to search in all of the available I<sections> following a pre-defined order (see B<DEFAULTS>), and to show only the first I<page> found, even if I<page> exists in several I<sections>.
ru: B<%man%> — это пейджер справочных страниц системы. Каждый параметр I<страница>, переданный B<%man%>, обычно является названием программы, утилиты или функции. По каждому из этих параметров выполняется поиск и вывод связанной с ним I<справочной страницы>. Если указан параметр I<раздел>, то это заставляет B<%man%> выполнять поиск только в этом справочном I<разделе>. Действием по умолчанию является поиск во всех доступных I<разделах> в заранее определённом порядке (смотрите B<DEFAULTS>) и показ только первой найденной I<страницы>, даже если существуют I<страницы> в нескольких I<разделах>.

note: type: Plain text
en: The table below shows the I<section> numbers of the manual followed by the types of pages they contain.
ru: В таблице ниже показаны номера справочных I<разделов> и описание их содержимого.

note: type: tbl table
en: Executable programs or shell commands
ru: Исполняемые программы или команды оболочки (shell)

note: type: tbl table
en: System calls (functions provided by the kernel)
ru: Системные вызовы (функции, предоставляемые ядром)

note: type: tbl table
en: Library calls (functions within program libraries)
ru: Библиотечные вызовы (функции, предоставляемые программными библиотеками)

note: type: tbl table
en: Special files (usually found in I</dev\/>)
ru: Специальные файлы (обычно находящиеся в каталоге I</dev\/>)

note: type: tbl table
en: File formats and conventions, e.g.\& I</etc/passwd>
ru: Форматы файлов и соглашения, например о I</etc/passwd>

note: type: tbl table
en: Games
ru: Игры

note: type: tbl table
en: Miscellaneous (including macro packages and conventions),
    e.g.\& B<man>(7), B<groff>(7), B<man-pages>(7)
ru: Разное (включает пакеты макросов и соглашения),
    например\& B<man>(7), B<groff>(7), B<man-pages>(7)

note: type: tbl table
en: System administration commands (usually only for root)
ru: Команды администрирования системы (обычно, запускаемые только суперпользователем)

note: type: tbl table
en: Kernel routines [\|Non standard\|]
ru: Процедуры ядра [\|нестандартный раздел\|]

note: type: Plain text
en: A manual I<page> consists of several sections.
ru: Справочная I<страница> состоит из нескольких разделов.

note: type: Plain text
en: Conventional section names include B<NAME>, B<SYNOPSIS>, B<CONFIGURATION>, B<DESCRIPTION>, B<OPTIONS>, B<EXIT\ STATUS>, B<RETURN\ VALUE>, B<ERRORS>, B<ENVIRONMENT>, B<FILES>, B<VERSIONS>, B<STANDARDS>, B<NOTES>, B<BUGS>, B<EXAMPLE>, B<AUTHORS>, and B<SEE\ ALSO>.
ru: Стандартные имена разделов: B<НАЗВАНИЕ> (B<NAME>), B<СИНТАКСИС> (B<SYNOPSIS>), B<НАСТРОЙКИ> (B<CONFIGURATION>), B<ОПИСАНИЕ> (B<DESCRIPTION>), B<ПАРАМЕТРЫ> (B<OPTIONS>), B<КОД\ ВЫХОДА> (B<EXIT\ STATUS>), B<ВОЗВРАЩАЕМОЕ\ ЗНАЧЕНИЕ> (B<RETURN\ VALUE>), B<ОШИБКИ> (B<ERRORS>), B<ОКРУЖЕНИЕ> (B<ENVIRONMENT>), B<ФАЙЛЫ> (B<FILES>), B<ВЕРСИИ> (B<VERSIONS>), B<СТАНДАРТЫ> (B<STANDARDS>), B<ЗАМЕЧАНИЯ> (B<NOTES>), B<ОШИБКИ> (B<BUGS>), B<ПРИМЕР> (B<EXAMPLE>), B<АВТОРЫ> (B<AUTHORS>) и B<СМОТРИТЕ\ ТАКЖЕ> (B<SEE\ ALSO>).

note: type: Plain text
en: The following conventions apply to the B<SYNOPSIS> section and can be used as a guide in other sections.
ru: В разделе B<СИНТАКСИС> используются следующие соглашения (которые также могут быть использованы в качестве основы для других разделов).

note: type: tbl table
en: B<bold text>
ru: B<текст жирным шрифтом>

note: type: tbl table
en: type exactly as shown.
ru: набирать точно как показано.

note: type: tbl table
en: I<italic text>
ru: I<текст курсивным шрифтом>

note: type: tbl table
en: replace with appropriate argument.
ru: заменить соответствующим значением.

note: type: tbl table
en: any or all arguments within [ ] are optional.
ru: любой или все параметры внутри [ ] необязательны.

note: type: tbl table
en: options delimited by | cannot be used together.
ru: параметры, разделённые |, не могут указываться одновременно.

note: type: tbl table
en: I<argument> .\|.\|.
ru: I<параметр> .\|.\|.

note: type: tbl table
en: I<argument> is repeatable.
ru: повторяющийся I<параметр>.

note: type: tbl table
en: [\|I<expression>\|] .\|.\|.
ru: [\|I<выражение>\|] .\|.\|.

note: type: tbl table
en: entire I<expression>\ within [ ] is repeatable.
ru: всё I<выражение>\ внутри [ ] может вводиться несколько раз.

note: type: Plain text
en: Exact rendering may vary depending on the output device.  For instance, man will usually not be able to render italics when running in a terminal, and will typically use underlined or coloured text instead.
ru: Точная отрисовка может отличаться на разных устройствах вывода. Например, man, обычно, не способна вывести курсив в терминале, и вместо него выведет текст подчёркнутым или цветным.

note: type: Plain text
en: The command or function illustration is a pattern that should match all possible invocations.  In some cases it is advisable to illustrate several exclusive invocations as is shown in the B<SYNOPSIS> section of this manual page.
ru: При объяснении команды или функции должен применяться шаблон, который точно описывает все возможные варианты вызова. В некоторых случаях рекомендуется показать несколько уникальных вызовов, как показано в разделе B<СИНТАКСИС> этой справочной страницы.

note: type: Plain text
en: Display the manual page for the I<item> (program)  I<ls>.
ru: Показать справочную страницу для I<параметра> (программы) I<ls>.

note: type: Plain text
en: Display the manual page for macro package I<man> from section I<7>.  (This is an alternative spelling of "B<%man%> I<7 man>".)
ru: Показать справочную страницу пакета макросов I<man> из раздела I<7> (аналог команды "B<%man%> I<7 man>").

note: type: Plain text
en: Display the manual page for macro package I<man> from section I<7>.  (This is another alternative spelling of "B<%man%> I<7 man>".  It may be more convenient when copying and pasting cross-references to manual pages.  Note that the parentheses must normally be quoted to protect them from the shell.)
ru: Показать справочную страницу пакета макросов I<man> из раздела I<7> (аналог команды "B<%man%> I<7 man>"; она удобнее для копирования и вставки перекрёстных ссылок в справочные страницы; заметим, что скобки нужно защищать кавычками из-за оболочки).

note: type: Plain text
en: Display, in succession, all of the available I<intro> manual pages contained within the manual.  It is possible to quit between successive displays or skip any of them.
ru: Показать подряд все доступные справочные страницы по I<intro>. В перерыве между показами можно пропустить следующую справочную страницу или закончить просмотр.

note: type: Plain text
en: Format the manual page for I<bash> into the default B<troff> or B<groff> format and pipe it to the printer named I<ps>.  The default output for B<groff> is usually PostScript.  B<%man% --help> should advise as to which processor is bound to the B<-t> option.
ru: Отформатировать справочную страницу для I<bash> в формат по умолчанию B<troff> или B<groff> и передать её по каналу в принтер с именем I<ps>. Обычно, форматом вывода B<groff> по умолчанию является PostScript. По команде B<%man% --help> можно посмотреть какой процессор привязан к параметру B<-t>.

note: type: Plain text
en: This command will decompress and format the nroff source manual page I<./foo.1x.gz> into a B<device independent (dvi)> file.  The redirection is necessary as the B<-T> flag causes output to be directed to B<stdout> with no pager.  The output could be viewed with a program such as B<xdvi> or further processed into PostScript using a program such as B<dvips>.
ru: Эта команда расжимает и форматирует справочную страницу в формате nroff I<./foo.1x.gz> в файл в формате B<независимом от устройства (dvi)>. Перенаправление вывода необходимо, так как при параметре B<-T> вывод направляется напрямую на B<стандартный вывод> без пейджера. Результат может быть просмотрен с помощью, например, B<xdvi> или преобразован в PostScript с помощью, например, B<dvips>.

note: type: Plain text
en: Search the short descriptions and manual page names for the keyword I<printf> as regular expression.  Print out any matches.  Equivalent to B<%apropos%>I<\ printf>B<.>
ru: Искать в кратких описаниях и именах справочных страниц ключевое слово I<printf>, рассматриваемое как регулярное выражение. Показать любые найденные совпадения. Эквивалентно вызову B<%apropos%>I<\ printf>B<.>

note: type: Plain text
en: Lookup the manual pages referenced by I<smail> and print out the short descriptions of any found.  Equivalent to B<%whatis%>I<\ smail>B<.>
ru: Искать справочные страницы, ссылающиеся на I<smail> и показать краткое описание любой найденной. Эквивалентно вызову B<%whatis%>I<\ smail>B<.>

note: type: SH
en: OVERVIEW
ru: ОБЗОР

note: type: Plain text
en: Many options are available to B<%man%> in order to give as much flexibility as possible to the user.  Changes can be made to the search path, section order, output processor, and other behaviours and operations detailed below.
ru: Многие параметры B<%man%> предназначены для предоставления как можно большей гибкости пользователю. Можно изменять путь поиска, порядок разделов, выходной обработчик и другие характеристики и операции — всё это подробно описано ниже.

note: type: Plain text
en: If set, various environment variables are interrogated to determine the operation of B<%man%>.  It is possible to set the "catch-all" variable $B<MANOPT> to any string in command line format, with the exception that any spaces used as part of an option's argument must be escaped (preceded by a backslash).  B<%man%> will parse $B<MANOPT> prior to parsing its own command line.  Those options requiring an argument will be overridden by the same options found on the command line.  To reset all of the options set in $B<MANOPT>, B<-D> can be specified as the initial command line option.  This will allow %man% to "forget" about the options specified in $B<MANOPT>, although they must still have been valid.
ru: В работе B<%man%> могут использоваться различные переменные окружения. Возможно задать любые параметры во «всеобъемлющей» переменной $B<MANOPT>, экранируя пробельные символы в значениях (с помощью обратной косой черты). B<%man%> разбирает $B<MANOPT> перед началом анализа параметров, переданных при вызове в командной строке. Все значения параметров, указанные в командной строке, заменят значения своих аналогов из переменной окружения. Для сброса всех параметров, установленных с помощью $B<MANOPT>, можно указать параметр B<-D> в начале командной строки. Это позволит %man% «забыть» о значениях, указанных в $B<MANOPT>, хотя они всё равно должны быть заданы правильно.

note: type: Plain text
en: Manual pages are normally stored in B<nroff>(1)  format under a directory such as I</usr/share/man>.  In some installations, there may also be preformatted I<cat pages> to improve performance.  See B<manpath>(5)  for details of where these files are stored.
ru: Обычно, справочные страницы хранятся в формате B<nroff>(1) в каталоге I</usr/share/man>. В некоторых установках для повышения производительности также могут существовать заранее отформатированные I<страницы cat>. Место хранения этих файлов описано в B<manpath>(5).

note: type: Plain text
en: This package supports manual pages in multiple languages, controlled by your I<locale>.  If your system did not set this up for you automatically, then you may need to set $B<LC_MESSAGES>, $B<LANG>, or another system-dependent environment variable to indicate your preferred locale, usually specified in the B<POSIX> format:
ru: Данный пакет обеспечивает поддержку справочных страниц на нескольких языках (через I<локаль>). Если система не настраивает её автоматически, то вам необходимо присвоить переменной $B<LC_MESSAGES>, $B<LANG> или другой переменной окружения (зависит от системы) значение локали предпочитаемого языка, обычно задаваемое в формате B<POSIX>:

note: type: Plain text
en: E<lt>I<language>E<gt>[\|B<_>E<lt>I<territory>E<gt>\|[\|B<.>E<lt>I<character-set>E<gt>\|[\|B<,>E<lt>I<version>E<gt>\|]\|]\|]
ru: E<lt>I<язык>E<gt>[\|B<_>E<lt>I<территория>E<gt>\|[\|B<.>E<lt>I<кодировка>E<gt>\|[\|B<,>E<lt>I<версия>E<gt>\|]\|]\|]

note: type: Plain text
en: If the desired page is available in your I<locale>, it will be displayed in lieu of the standard (usually American English) page.
ru: Если запрашиваемая страница доступна для вашей I<локали>, то она будет показана вместо стандартной (обычно, на американском английском) страницы.

note: type: Plain text
en: If you find that the translations supplied with this package are not available in your native language and you would like to supply them, please contact the maintainer who will be coordinating such activity.
ru: Если вы обнаружили, что этот пакет не переведён ваш язык и вы хотите сделать это, то свяжитесь с сопровождающим, который скоординирует данную работу.

note: type: Plain text
en: Individual manual pages are normally written and maintained by the maintainers of the program, function, or other topic that they document, and are not included with this package.  If you find that a manual page is missing or inadequate, please report that to the maintainers of the package in question.
ru: Отдельные справочные страницы пишутся и поддерживаются сопровождающими программы, функции или другой части, которую они описывают, и не включены в этот пакет. Если вы обнаружите отсутствие или некорректность справочной страницы, сообщите сопровождающим конкретного пакета.

note: type: Plain text
en: For information regarding other features and extensions available with this manual pager, please read the documents supplied with the package.
ru: О других возможностях и расширениях, доступных в этом пейджере справочных страниц, читайте в описаниях из этого пакета.

note: type: SH
en: DEFAULTS
ru: ЗНАЧЕНИЯ ПО УМОЛЧАНИЮ

note: type: Plain text
en: The order of sections to search may be overridden by the environment variable $B<MANSECT> or by the B<SECTION> directive in I<%manpath_config_file%>.  By default it is as follows:
ru: Порядок поиска по разделам можно изменить через переменную окружения $B<MANSECT> или директиву B<SECTION> в I<%manpath_config_file%>. Значение по умолчанию следующее:

note: type: Plain text
en: The formatted manual page is displayed using a I<pager>.  This can be specified in a number of ways, or else will fall back to a default (see option B<-P> for details).
ru: Отформатированная справочная страница отображается I<пейджером>. Его можно задать несколькими способами, в противном случае будет использовано значение по умолчанию (смотрите описание параметра B<-P>).

note: type: Plain text
en: The filters are deciphered by a number of means.  Firstly, the command line option B<-p> or the environment variable $B<MANROFFSEQ> is interrogated.  If B<-p> was not used and the environment variable was not set, the initial line of the nroff file is parsed for a preprocessor string.  To contain a valid preprocessor string, the first line must resemble
ru: Фильтры можно указывать разными способами. Во-первых, обрабатывается значение параметра B<-p> или переменная окружения $B<MANROFFSEQ>. Если B<-p> не указывалась и переменная окружения не установлена, то в поисках строки препроцессора анализируется первая строка nroff файла. Чтобы указывать строку препроцессора правильно, первая строка должна быть в формате

note: type: Plain text
en: B<'\e"> E<lt>B<string>E<gt>
ru: B<'\e"> E<lt>B<строка>E<gt>

note: type: Plain text
en: where B<string> can be any combination of letters described by option B<-p> below.
ru: где B<строка> может содержать комбинацию букв, описанных в параметре B<-p> ниже.

note: type: Plain text
en: If none of the above methods provide any filter information, a default set is used.
ru: Если информация о фильтре нигде не указана, то используется набор по умолчанию.

note: ******************************************************************** type: Plain text
en: A formatting pipeline is formed from the filters and the primary formatter (B<nroff> or [B<tg>]B<roff> with B<-t>)  and executed.  Alternatively, if an executable program I<mandb_nfmt> (or I<mandb_tfmt> with B<-t>)  exists in the man tree root, it is executed instead.  It gets passed the manual source file, the preprocessor string, and optionally the device specified with B<-T> or B<-E> as arguments.
ru: Конвейер форматирования создаётся из фильтров и основной программы форматирования (B<nroff> или [B<tg>]B<roff> с параметром B<-t>) и выполняется. Или же, если существует исполняемая программа I<mandb_nfmt> (или I<mandb_tfmt> с параметром B<-t>) в корне дерева справочных страниц, то выполняется именно она. Она получает файл с исходным текстом справочной страницы, строку препроцессора, и, необязательно, устройство, указанное в параметре B<-T> или B<-E>.

note: type: Plain text
en: Non-argument options that are duplicated either on the command line, in $B<MANOPT>, or both, are not harmful.  For options that require an argument, each duplication will override the previous argument value.
ru: Параметры без значений, повторяющиеся в командной строки, $B<MANOPT> или обоих, не опасны. В случае с параметрами со значением, при каждом повторении новое значение заменяет имеющееся.

note: type: SS
en: General options
ru: Общие параметры

note: type: Plain text
en: This option is normally issued as the very first option and resets B<%man%'s> behaviour to its default.  Its use is to reset those options that may have been set in $B<MANOPT>.  Any options that follow B<-D> will have their usual effect.
ru: Этот параметр обычно вводится самым первым, и указывает B<%man%> активировать поведение по умолчанию. Он используется для сброса параметров, которые могли быть установлены через переменную окружения $B<MANOPT>. Любые параметры, указанные после B<-D>, будут действовать как обычно.

note: type: TP
en: B<--warnings>[=I<warnings\/>]
ru: B<--warnings>[=I<предупреждения\/>]

note: type: Plain text
en: Enable warnings from I<groff>.  This may be used to perform sanity checks on the source text of manual pages.  I<warnings> is a comma-separated list of warning names; if it is not supplied, the default is "mac".  To disable a I<groff> warning, prefix it with "!": for example, B<--warnings=mac,!break> enables warnings in the "mac" category and disables warnings in the "break" category.  See the \(lqWarnings\(rq node in B<info groff> for a list of available warning names.
ru: Включить предупреждения от I<groff>. Это может быть использовано для проверки тривиальных ошибок в исходном тексте справочных страниц. I<Предупреждения> представляют собой список названий предупреждений через запятую; если он не указан, то по умолчанию используется значение «mac». ЧТобы отключить предупреждение I<groff>, поставьте перед ним «!»: например, B<--warnings=mac,!break> включает предупреждения в категории «mac» и отключает предупреждения в категории «break». Список доступных предупреждений можно найти в B<info groff>, раздел \(lqПредупреждения\(rq.

note: type: SS
en: Main modes of operation
ru: Основные режимы работы

note: type: Plain text
en: Approximately equivalent to B<%whatis%>.  Display a short description from the manual page, if available.  See B<%whatis%>(1)  for details.
ru: Примерно эквивалентно работе B<%whatis%>. Отображает краткое описание из справочной страницы, если оно есть. Подробней смотрите B<%whatis%>(1).

note: type: Plain text
en: Approximately equivalent to B<%apropos%>.  Search the short manual page descriptions for keywords and display any matches.  See B<%apropos%>(1)  for details.
ru: Примерно эквивалентно работе B<%apropos%>. Ищет в кратких описаниях справочных страниц ключевые слова и показывает любые совпадения. Подробней смотрите B<%apropos%>(1).

note: type: Plain text
en: Search for text in all manual pages.  This is a brute-force search, and is likely to take some time; if you can, you should specify a section to reduce the number of pages that need to be searched.  Search terms may be simple strings (the default), or regular expressions if the B<--regex> option is used.
ru: Поиск текста во всех справочных страницах. Используется простой поиск перебором, что занимает определённое время; если можно, указывайте раздел для сокращения числа страниц, в которых нужно искать. Термины поиска могут быть простыми строками (по умолчанию), или регулярными выражениями, если указан параметр B<--regex>.

note: type: Plain text
en: Note that this searches the I<sources> of the manual pages, not the rendered text, and so may include false positives due to things like comments in source files, or false negatives due to things like hyphens being written as "\e-" in source files.  Searching the rendered text would be much slower.
ru: Заметим, что данный поиск выполняется по I<исходному тексту> справочных страниц, а не по отображаемому тексту, и поэтому может включать ложноположительные результаты, например, из-за комментариев в исходных файлах или ложноотрицательные результаты из-за дефисов, записанных в виде "\e-" в исходных файлах. Поиск по отображаемому тексту выполнялся бы намного медленнее.

note: Compressed nroff source files with a supported compression extension will be decompressed by man prior to being displaying via the usual filters. type: Plain text
en: Activate "local" mode.  Format and display local manual files instead of searching through the system's manual collection.  Each manual page argument will be interpreted as an nroff source file in the correct format.  No cat file is produced.  If '-' is listed as one of the arguments, input will be taken from stdin.
ru: Включить «локальный» режим. Форматирует и показывает локальные справочные файлы, а не ищет их в справочной коллекции системы. Каждый параметр справочной страницы считается именем правильно отформатированного исходного файла nroff. Cat файлы не создаются. Если в качестве одного из параметров указан «-», то данные будут взяты из стандартного входного потока.

note: type: Plain text
en: If this option is not used, then B<%man%> will also fall back to interpreting manual page arguments as local file names if the argument contains a "/" character, since that is a good indication that the argument refers to a path on the file system.
ru: Если этот параметр не используется, то B<%man%> также попытается проверить не являются ли аргументы справочных страниц именами локальных файлов, если аргумент содержит символ «/», так как это хороший признак того, что аргумент указывает на путь в файловой системе.

note: type: Plain text
en: Don't actually display the manual page, but do print the location of the source nroff file that would be formatted.  If the B<-a> option is also used, then print the locations of all source files that match the search criteria.
ru: Не выводить содержимое справочной страницы, а показать место нахождения исходного файла nroff, который был бы отформатирован. Если также указан параметр B<-a>, то вывести расположения всех исходных файлов, которые подпадают под критерии поиска.

note: type: Plain text
en: Don't actually display the manual page, but do print the location of the preformatted cat file that would be displayed.  If the B<-a> option is also used, then print the locations of all preformatted cat files that match the search criteria.
ru: Не выводить содержимое справочной страницы, а показать место нахождения отформатированного файла cat, который был бы показан. Если также указан параметр B<-a>, то вывести расположения всех отформатированных файлов, которые подпадают под критерии поиска.

note: type: Plain text
en: If B<-w> and B<-W> are both used, then print both source file and cat file separated by a space.  If all of B<-w>, B<-W>, and B<-a> are used, then do this for each possible match.
ru: Если указаны параметры B<-w> и B<-W>, и вывести исходный файл и файл cat, разделив их пробелом. Если указаны сразу B<-w>, B<-W> и B<-a>, то сделать это для каждого возможного совпадения.

note: type: Plain text
en: This option is not for general use and should only be used by the B<%catman%> program.
ru: Этот параметр не для обычного использования, и должен использоваться только программой B<%catman%>.

note: type: TP
en: B<-R\ >I<encoding>,\ B<--recode>=I<encoding>
ru: B<-R\ >I<кодировка>,\ B<--recode>=I<кодировка>

note: type: Plain text
en: Instead of formatting the manual page in the usual way, output its source converted to the specified I<encoding>.  If you already know the encoding of the source file, you can also use B<%manconv%>(1)  directly.  However, this option allows you to convert several manual pages to a single encoding without having to explicitly state the encoding of each, provided that they were already installed in a structure similar to a manual page hierarchy.
ru: Вместо обычного форматирования справочной страницы можно преобразовать исходный текст в заданную I<кодировку>. Если вам уже известна кодировка исходного файла, то вы можете также использовать непосредственно B<%manconv%>(1). Однако, этот параметр позволяет преобразовывать несколько справочных страниц в одну кодировку без явного указания кодировки каждой страницы, предполагая, что они уже установлены в структуру, подобную иерархии справочных страниц.

note: type: Plain text
en: Consider using B<%man_recode%>(1)  instead for converting multiple manual pages, since it has an interface designed for bulk conversion and so can be much faster.
ru: Попробуйте использовать B<%man_recode%>(1) вместо преобразования множества справочных страниц, так как его интерфейс разработан для группового преобразования и может выполнить эту задачу намного быстрее.

note: type: SS
en: Finding manual pages
ru: Поиск справочных страниц

note: type: Plain text
en: If this system has access to other operating systems' manual pages, they can be accessed using this option.  To search for a manual page from NewOS's manual page collection, use the option B<-m> B<NewOS>.
ru: Если система имеет доступ к справочным страницам других операционных систем, то к ним можно обратиться с помощью этого параметра. Чтобы найти справочную страницу из коллекции страниц для операционной системы NewOS, укажите B<-m> B<NewOS>.

note: type: Plain text
en: The I<system> specified can be a combination of comma delimited operating system names.  To include a search of the native operating system's manual pages, include the system name B<man> in the argument string.  This option will override the $B<SYSTEM> environment variable.
ru: В значении I<система> может указать несколько имён операционных систем через запятую. Чтобы включить поиск по справочным страницам родной операционной системы, добавьте системное имя B<man> в это значение. Этот параметр заменяет значение переменной окружения $B<SYSTEM>.

note: type: Plain text
en: Specify an alternate manpath to use.  By default, B<%man%> uses B<%manpath%> derived code to determine the path to search.  This option overrides the $B<MANPATH> environment variable and causes option B<-m> to be ignored.
ru: Задать альтернативный manpath для работы. По умолчанию, для определения пути поиска B<%man%> использует B<%manpath%>, указанный в исходном коде программы. Этот параметр заменяет значение переменной окружения $B<MANPATH> и выключает действие параметра B<-m>.

note: type: Plain text
en: A path specified as a manpath must be the root of a manual page hierarchy structured into sections as described in the man-db manual (under "The manual page system").  To view manual pages outside such hierarchies, see the B<-l> option.
ru: Задаваемый в качестве manpath путь должен быть корнем иерархии справочных страниц, разделённой на разделы, описанных в справочной странице по man-db (в разделе "Система справочных страниц"). Для просмотра справочных страниц вне этих иерархий, используйте параметр B<-l>.

note: type: TP
en: B<-S> I<list\/>, B<-s> I<list\/>, B<--sections=>I<list\/>
ru: B<-S> I<список\/>, B<-s> I<список\/>, B<--sections=>I<список\/>

note: type: Plain text
en: The given I<list> is a colon- or comma-separated list of sections, used to determine which manual sections to search and in what order.  This option overrides the $B<MANSECT> environment variable.  (The B<-s> spelling is for compatibility with System V.)
ru: Задаваемый I<список> разделов, перечисляемых через запятую, используется для определения разделов руководства поиска и их порядка. Этот параметр заменяет значение переменной окружения $B<MANSECT> (параметр B<-s> введён для совместимости с System V).

note: type: TP
en: B<-e\ >I<sub-extension>,\ B<--extension=>I<sub-extension>
ru: B<-e\ >I<доп.расширение>,\ B<--extension=>I<доп.расширение>

note: type: Plain text
en: Some systems incorporate large packages of manual pages, such as those that accompany the B<Tcl> package, into the main manual page hierarchy.  To get around the problem of having two manual pages with the same name such as B<exit>(3), the B<Tcl> pages were usually all assigned to section B<l>.  As this is unfortunate, it is now possible to put the pages in the correct section, and to assign a specific "extension" to them, in this case, B<exit>(3tcl).  Under normal operation, B<%man%> will display B<exit>(3)  in preference to B<exit>(3tcl).  To negotiate this situation and to avoid having to know which section the page you require resides in, it is now possible to give B<%man%> a I<sub-extension> string indicating which package the page must belong to.  Using the above example, supplying the option B<-e\ tcl> to B<%man%> will restrict the search to pages having an extension of B<*tcl>.
ru: Некоторые системы включают большое число пакетов справочных страниц, например таких, которые поставляются с пакетом B<Tcl>, в главную иерархию справочных страниц. Для решения проблемы появления двух справочных страниц с одинаковым именем, например, B<exit>(3), все страницы B<Tcl>, обычно, помещаются в раздел B<l>. Но для страниц такого типа уже определён правильный раздел (3). Теперь возможно помещать страницы в правильный раздел, и назначать им специальное «расширение», в данном случае, B<exit>(3tcl). Обычно, B<%man%> показывает B<exit>(3), а не B<exit>(3tcl). Чтобы преодолеть это и не запоминать в каком разделе лежит определённая страница, теперь возможно передать B<%man%> строку I<доп.расширения>, указывающую какому пакету должна принадлежать страница. Возвращаясь к примеру выше, укажите параметр B<-e\ tcl> для B<%man%>, чтобы ограничить поиск только страницами с расширением B<*tcl>.

note: type: Plain text
en: Ignore case when searching for manual pages.  This is the default.
ru: Игнорировать регистр при поиске справочных страниц. Включено по умолчанию.

note: type: Plain text
en: Search for manual pages case-sensitively.
ru: Искать справочные страницы с учётом регистра символов.

note: type: Plain text
en: Show all pages with any part of either their names or their descriptions matching each I<page> argument as a regular expression, as with B<apropos>(1).  Since there is usually no reasonable way to pick a "best" page when searching for a regular expression, this option implies B<-a>.
ru: Показывает все страницы, у которых какая-то часть в имени или в описании совпадает с параметром I<страница>, заданным в виде регулярного выражения, также как B<apropos>(1). Так как, обычно, нет разумного способа определить "лучшую" страницу при поиске по регулярному выражению, то этот параметр подразумевает B<-a>.

note: type: Plain text
en: Show all pages with any part of either their names or their descriptions matching each I<page> argument using shell-style wildcards, as with B<apropos>(1)  B<--wildcard>.  The I<page> argument must match the entire name or description, or match on word boundaries in the description.  Since there is usually no reasonable way to pick a "best" page when searching for a wildcard, this option implies B<-a>.
ru: Показывает все страницы, у которых какая-то часть в имени или в описании совпадает с параметром I<страница>, заданным в виде групповых символов, также как в B<apropos>(1) B<--wildcard>. Значение I<страница> должно полностью совпадать с именем или описанием, или совпадать по границе слов в описании. Так как, обычно, нет разумного способа определить "лучшую" страницу при поиске по регулярному выражению, то этот параметр подразумевает B<-a>.

note: type: Plain text
en: If the B<--regex> or B<--wildcard> option is used, match only page names, not page descriptions, as with B<whatis>(1).  Otherwise, no effect.
ru: Если указан параметр B<--regex> или B<--wildcard>, то совпадения ищутся только в именах страниц, а не в описании страницы, как в B<whatis>(1). Иначе, этого не происходит.

note: type: Plain text
en: By default, B<%man%> will exit after displaying the most suitable manual page it finds.  Using this option forces B<%man%> to display all the manual pages with names that match the search criteria.
ru: По умолчанию, B<%man%> завершает работу после показа наиболее подходящей найденной справочной страницы. Этот параметр заставляет B<%man%> показать все справочные страницы с именами, которые удовлетворяют критериям поиска.

note: type: Plain text
en: This option causes B<%man%> to update its database caches of installed manual pages.  This is only needed in rare situations, and it is normally better to run B<%mandb%>(8)  instead.
ru: Данный параметр заставляет B<%man%> обновить свои кэши базы данные установленных справочных страниц. Это требуется очень редко и для этого, обычно, лучше запускать B<%mandb%>(8).

note: type: Plain text
en: By default, B<%man%> will try to interpret pairs of manual page names given on the command line as equivalent to a single manual page name containing a hyphen or an underscore.  This supports the common pattern of programs that implement a number of subcommands, allowing them to provide manual pages for each that can be accessed using similar syntax as would be used to invoke the subcommands themselves.  For example:
ru: По умолчанию, B<%man%> пытается интерпретировать пары имён справочных страниц, указанных в командной строке, как единое имя справочной страницы, содержащее символ переноса или подчёркивания. Это поддерживает общую систему программ, которые имеют несколько подкоманд, позволяя для каждой из них предоставлять справочные страницы используя синтаксис, похожий на вызов самих подкоманд. Например:

note: type: Plain text
en: To disable this behaviour, use the B<--no-subpages> option.
ru: Чтобы выключить такое поведение, укажите параметр B<--no-subpages>.

note: type: SS
en: Controlling formatted output
ru: Контролирование форматированного вывода

note: type: TP
en: B<-P\ >I<pager>,\ B<--pager=>I<pager>
ru: B<-P\ >I<пейджер>,\ B<--pager=>I<пейджер>

note: type: Plain text
en: Specify which output pager to use.  By default, B<%man%> uses B<%pager%>, falling back to B<%cat%> if B<%pager%> is not found or is not executable.  This option overrides the $B<MANPAGER> environment variable, which in turn overrides the $B<PAGER> environment variable.  It is not used in conjunction with B<-f> or B<-k>.
ru: Указывает, какой пейджер использовать для вывода. По умолчанию, B<%man%> использует B<%pager%> и применяет B<%cat%>, если B<%pager%> не найден или не является исполняемым файлом. Этот параметр заменяет значение переменной окружения $B<MANPAGER> которая, в свою очередь, заменяет значение переменной окружения $B<PAGER>. Не используется вместе с B<-f> или B<-k>.

note: type: Plain text
en: The value may be a simple command name or a command with arguments, and may use shell quoting (backslashes, single quotes, or double quotes).  It may not use pipes to connect multiple commands; if you need that, use a wrapper script, which may take the file to display either as an argument or on standard input.
ru: Значением может быть просто имя команды или команды с параметрами, можно использовать экранирование интерпретатора команд (обратные слэши, одиночные кавычки или двойные кавычки). Нельзя объединять несколько команд каналами; если эту нужно, создайте сценарий-обёртку, который получает файл для показа в виде параметра или со стандартного ввода.

note: type: TP
en: B<-r\ >I<prompt>,\ B<--prompt=>I<prompt>
ru: B<-r\ >I<приглашение>,\ B<--prompt=>I<приглашение>

note: type: Plain text
en: If a recent version of B<less> is used as the pager, B<%man%> will attempt to set its prompt and some sensible options.  The default prompt looks like
ru: Если в качестве пейджера используется новая версия B<less>, то B<%man%> будет пытаться установить ей формат приглашения и некоторые значимые параметры. По умолчанию приглашение выглядит как

note: type: Plain text
en: B< Manual page>I< name>B<(>I<sec>B<) line>I< x>
ru: B< Manual page>I< имя>B<(>I<раздел>B<) line>I< x>

note: The default options are .BR \-six8 . The actual default will depend on your chosen .BR locale . type: Plain text
en: where I<name> denotes the manual page name, I<sec> denotes the section it was found under and I<x> the current line number.  This is achieved by using the $B<LESS> environment variable.
ru: где I<имя> это имя справочной страницы, I<раздел> — раздел, в котором она была найдена и I<x> — номер текущей строки. Приглашение устанавливается с помощью переменной окружения $B<LESS>.

note: You may need to do this if your version of .B less rejects the default options or if you prefer a different prompt. type: Plain text
en: Supplying B<-r> with a string will override this default.  The string may contain the text B<$MAN_PN> which will be expanded to the name of the current manual page and its section name surrounded by "(" and ")".  The string used to produce the default could be expressed as
ru: Данное значение по умолчанию можно изменить с помощью параметра B<-r>. Значение параметра может содержать текст B<$MAN_PN>, вместо которого подставляется имя текущей справочной страницы и её название раздела, окружённое «(» и «)». Строка, используемая для создания приглашения по умолчанию, могла бы выглядеть как

note: type: Plain text
en: B<\e\ Manual\e\ page\e\ \e$MAN_PN\e\ ?ltline\e\ %lt?L/%L.:>
ru: B<\e\ Справочная\e\ страница\e\ \e$MAN_PN\e\ ?ltстрока\e\ %lt?L/%L.:>

note: type: Plain text
en: B<byte\e\ %bB?s/%s..?\e\ (END):?pB\e\ %pB\e\e%..>
ru: B<byte\e\ %bB?s/%s..?\e\ (ВСЕ):?pB\e\ %pB\e\e%..>

note: type: Plain text
en: B<(press h for help or q to quit)>
ru: B<(h — справка, q — выход)>

note: type: Plain text
en: It is broken into three lines here for the sake of readability only.  For its meaning see the B<less>(1)  manual page.  The prompt string is first evaluated by the shell.  All double quotes, back-quotes and backslashes in the prompt must be escaped by a preceding backslash.  The prompt string may end in an escaped $ which may be followed by further options for less.  By default B<%man%> sets the B<-ix8> options.
ru: Здесь она разделена на три строки только для повышения читаемости. Описание её составных частей смотрите в справочной странице B<less>(1). Строка приглашения сначала обрабатывается оболочкой командной строки. Все двойные кавычки, обратные кавычки и обратные косые черты в приглашении должны предваряться обратными косыми чертами для экранирования. Строка приглашения может заканчиваться экранированным $, за которым можно указать другие параметры less. По умолчанию, B<%man%> указывает параметры B<-ix8>.

note: type: Plain text
en: The $B<MANLESS> environment variable described below may be used to set a default prompt string if none is supplied on the command line.
ru: Переменная окружения $B<MANLESS>, описанная ниже, может использоваться для назначения строки приглашения по умолчанию, если это не задано в командной строке.

note: type: Plain text
en: When viewing a pure I<ascii>(7)  manual page on a 7 bit terminal or terminal emulator, some characters may not display correctly when using the I<latin1>(7)  device description with B<GNU> B<nroff>.  This option allows pure I<ascii> manual pages to be displayed in I<ascii> with the I<latin1> device.  It will not translate any I<latin1> text.  The following table shows the translations performed: some parts of it may only be displayed properly when using B<GNU> B<nroff>'s I<latin1>(7)  device.
ru: При просмотре справочной страницы в изначальной кодировке I<ascii>(7) на 7-битном терминале или эмуляторе терминала при использовании описания устройства I<latin1>(7) с B<GNU> B<nroff> некоторые символы могут неправильно отображаться . Этот параметр позволяет справочным страницам в изначальной I<ascii> отображаться в I<ascii>, используя устройство I<latin1>. Любой I<latin1> текст не будет транслироваться. Следующая таблица показывает выполняемые трансляции: некоторые её части могут отображаться правильно только при использовании B<GNU> B<nroff> устройства I<latin1>(7).

note: type: tbl table
en: Description
ru: Описание

note: type: tbl table
en: Octal
ru: Восьмеричный код

note: type: tbl table
en: continuation hyphen
ru: длинный перенос

note: type: tbl table
en: bullet (middle dot)
ru: bullet (точка в центре)

note: type: tbl table
en: acute accent
ru: значок ударения

note: type: tbl table
en: multiplication sign
ru: знак ударения

note: type: Plain text
en: If the I<latin1> column displays correctly, your terminal may be set up for I<latin1> characters and this option is not necessary.  If the I<latin1> and I<ascii> columns are identical, you are reading this page using this option or B<%man%> did not format this page using the I<latin1> device description.  If the I<latin1> column is missing or corrupt, you may need to view manual pages with this option.
ru: Если колонка I<latin1> отображается правильно, то ваш терминал может быть настроен для отображения символов I<latin1> и этот параметр ненужен. Если колонки I<latin1> и I<ascii> одинаковы, то вы читаете эту страницу с помощью данного параметра, или B<%man%> не отформатировал страницу с помощью описания устройства I<latin1>. Если колонка I<latin1> отсутствует или повреждена, то вам может потребоваться просматривать справочные страницы с помощью этого параметра.

note: type: Plain text
en: This option is ignored when using options B<-t>, B<-H>, B<-T>, or B<-Z> and may be useless for B<nroff> other than B<GNU's>.
ru: Этот параметр игнорируется при использовании параметров B<-t>, B<-H>, B<-T> или B<-Z>, и может быть бесполезен для B<nroff>, если он не от B<GNU>.

note: type: TP
en: B<-E\ >I<encoding>,\ B<--encoding>=I<encoding>
ru: B<-E\ >I<кодировка>,\ B<--encoding>=I<кодировка>

note: type: Plain text
en: Generate output for a character encoding other than the default.  For backward compatibility, I<encoding> may be an B<nroff> device such as B<ascii>, B<latin1>, or B<utf8> as well as a true character encoding such as B<UTF-8>.
ru: Сгенерировать вывод в символьной кодировке, отличной от используемой по умолчанию. Кроме реальной символьной кодировки, типа B<UTF-8>, для обратной совместимости в I<кодировке> можно указывать устройство B<nroff>, например, B<ascii>, B<latin1> или B<utf8>.

note: type: Plain text
en: Normally, B<nroff> will automatically hyphenate text at line breaks even in words that do not contain hyphens, if it is necessary to do so to lay out words on a line without excessive spacing.  This option disables automatic hyphenation, so words will only be hyphenated if they already contain hyphens.
ru: Обычно, B<nroff> автоматически разбивает текст при окончании строки даже на словах, у которых нет переносов, если это необходимо для размещения слов в строке для избежания лишних пробелов. Этот параметр отключает автоматический перенос; в результате перенос выполняется только для слов, в которых есть символы переноса.

note: type: Plain text
en: If you are writing a manual page and simply want to prevent B<nroff> from hyphenating a word at an inappropriate point, do not use this option, but consult the B<nroff> documentation instead; for instance, you can put "\e%" inside a word to indicate that it may be hyphenated at that point, or put "\e%" at the start of a word to prevent it from being hyphenated.
ru: Если вы пишите справочную страницу и просто хотите отключить в B<nroff> перенос в словах в неподходящем месте, не используйте этот параметр, а почитайте документацию к B<nroff>; например, вы можете поместить "\e%" внутрь слова в место возможного разрыва, или поместить "\e%" в начало слова, что не даст его разорвать совсем.

note: type: Plain text
en: Normally, B<nroff> will automatically justify text to both margins.  This option disables full justification, leaving justified only to the left margin, sometimes called "ragged-right" text.
ru: Обычно, B<nroff> автоматически выравнивает текст по обеим границам. Этот параметр выключает полное выравнивание, оставляя выравнивание по левому краю, получается так называемый текст "без выключки по правому краю".

note: type: Plain text
en: If you are writing a manual page and simply want to prevent B<nroff> from justifying certain paragraphs, do not use this option, but consult the B<nroff> documentation instead; for instance, you can use the ".na", ".nf", ".fi", and ".ad" requests to temporarily disable adjusting and filling.
ru: Если вы пишите справочную страницу и просто хотите отключить в B<nroff> выравнивание в некоторых параграфах, не используйте этот параметр, а почитайте документацию к B<nroff>; например, вы можете использовать запросы ".na", ".nf", ".fi", и ".ad" для временного отключения выравнивания и заполнения.

note: type: TP
en: B<-p\ >I<string>,\ B<--preprocessor=>I<string>
ru: B<-p\ >I<строка>,\ B<--preprocessor=>I<строка>

note: type: Plain text
en: Specify the sequence of preprocessors to run before B<nroff> or B<troff>/B<groff>.  Not all installations will have a full set of preprocessors.  Some of the preprocessors and the letters used to designate them are: B<eqn> (B<e>), B<grap> (B<g>), B<pic> (B<p>), B<tbl> (B<t>), B<vgrind> (B<v>), B<refer> (B<r>).  This option overrides the $B<MANROFFSEQ> environment variable.  B<%zsoelim%> is always run as the very first preprocessor.
ru: Задать последовательность препроцессоров для запуска перед B<nroff> или B<troff>/B<groff>. Не во всех системах имеется полный набор препроцессоров. Некоторые препроцессоры и буквы, используемые для их обозначения: B<eqn> (B<e>), B<grap> (B<g>), B<pic> (B<p>), B<tbl> (B<t>), B<vgrind> (B<v>), B<refer> (B<r>). Этот параметр заменяет значение переменной окружения $B<MANROFFSEQ>. B<%zsoelim%> запускается всегда в качестве первого очень быстрого препроцессора.

note: type: Plain text
en: Use I<%troff%> to format the manual page to stdout.  This option is not required in conjunction with B<-H>, B<-T>, or B<-Z>.
ru: Использовать I<%troff%> для форматирования справочной страницы и вывода в стандартный выходной поток. Этот параметр не требуется вместе с B<-H>, B<-T> или B<-Z>.

note: type: TP
en: B<-T>[I<device\/>], B<--troff-device>[=I<device\/>]
ru: B<-T>[I<устройство\/>], B<--troff-device>[=I<устройство\/>]

note: type: TP
en: B<-H>[I<browser\/>], B<--html>[=I<browser\/>]
ru: B<-H>[I<браузер\/>], B<--html>[=I<браузер\/>]

note: type: Plain text
en: This option will cause B<groff> to produce HTML output, and will display that output in a web browser.  The choice of browser is determined by the optional I<browser> argument if one is provided, by the $B<BROWSER> environment variable, or by a compile-time default if that is unset (usually B<lynx>).  This option implies B<-t>, and will only work with B<GNU> B<troff>.
ru: Этот параметр заставляет B<groff> создавать HTML -страницу, и отображать её в веб-браузере. Выбор браузера определяется необязательным значением I<браузер>, переменной окружения $B<BROWSER>, или, если ничего не указано, значением по умолчанию, установленным при компиляции программы (обычно B<lynx>). Этот параметр предполагает B<-t>, и работает только с B<GNU> B<troff>.

note: type: Plain text
en: This option displays the output of B<groff> in a graphical window using the B<gxditview> program.  The I<dpi> (dots per inch) may be 75, 75-12, 100, or 100-12, defaulting to 75; the -12 variants use a 12-point base font.  This option implies B<-T> with the X75, X75-12, X100, or X100-12 device respectively.
ru: С этим параметром вывод B<groff> осуществляет в графическое окно с помощью программы B<gxditview>. Значениями I<dpi> (точек на дюйм) могут быть 75, 75-12, 100 или 100-12; по умолчанию 75; в вариантах с -12 в конце используется базовый шрифт в 12 точек. Этот параметр подразумевает B<-T> со значениями устройств X75, X75-12, X100 и X100-12 соответственно.

note: type: Plain text
en: B<groff> will run B<troff> and then use an appropriate post-processor to produce output suitable for the chosen device.  If I<%troff%> is B<groff>, this option is passed to B<groff> and will suppress the use of a post-processor.  It implies B<-t>.
ru: B<groff> запустит B<troff>, а затем использует соответствующий постпроцессор для создания результата, подходящего для выбранного устройства. Если I<%troff%> совпадает с B<groff>, то данный параметр передаётся B<groff> и использование постпроцессора отменяется. Подразумевает B<-t>.

note: type: SS
en: Getting help
ru: Выдача справки

note: type: Plain text
en: A child process returned a non-zero exit status.
ru: Дочерний процесс завершился с ненулевым кодом выхода.

note: type: Plain text
en: At least one of the pages/files/keywords didn't exist or wasn't matched.
ru: По крайней мере одна из страниц/файлов/ключевых слов не существует или для неё при поиске ничего не найдено.

note: type: Plain text
en: If $B<MANPATH> is set, its value is used as the path to search for manual pages.
ru: Если установлена переменная окружения $B<MANPATH>, то её значение используется в качестве пути поиска справочных страниц.

note: type: Plain text
en: Every time B<man> invokes the formatter (B<nroff>, B<troff>, or B<groff>), it adds the contents of $B<MANROFFOPT> to the formatter's command line.
ru: Всякий раз, когда B<man> вызывает программу форматирования (B<nroff>, B<troff> или B<groff>) в её командную строку добавляется содержимое $B<MANROFFOPT>.

note: type: Plain text
en: If $B<MANROFFSEQ> is set, its value is used to determine the set of preprocessors to pass each manual page through.  The default preprocessor list is system dependent.
ru: Если установлена переменная окружения $B<MANROFFSEQ>, то её значение используется для определения набора препроцессоров для обработки каждой справочной страницы. Список препроцессоров по умолчанию зависит от системы.

note: type: Plain text
en: If $B<MANSECT> is set, its value is a colon-delimited list of sections and it is used to determine which manual sections to search and in what order.  The default is "%sections%", unless overridden by the B<SECTION> directive in I<%manpath_config_file%>.
ru: Если установлена переменная окружения $B<MANSECT>, то её значением является список разделов, указанных через двоеточие, и она используется для задания разделов справочных страниц, в которых будет производится поиск и в каком порядке. Значением по умолчанию является «%sections%», если оно не заменено директивой B<SECTION> в I<%manpath_config_file%>.

note: type: Plain text
en: If $B<MANPAGER> or $B<PAGER> is set ($B<MANPAGER> is used in preference), its value is used as the name of the program used to display the manual page.  By default, B<%pager%> is used, falling back to B<%cat%> if B<%pager%> is not found or is not executable.
ru: Если установлена переменная окружения $B<MANPAGER> или $B<PAGER> ($B<MANPAGER> просматривается первой), то в ней задано имя программы для отображения справочной страницы. По умолчанию, используется B<%pager%> или B<%cat%>, если B<%pager%> не найден или не является исполняемым файлом.

note: type: Plain text
en: If $B<MANLESS> is set, its value will be used as the default prompt string for the B<less> pager, as if it had been passed using the B<-r> option (so any occurrences of the text B<$MAN_PN> will be expanded in the same way).  For example, if you want to set the prompt string unconditionally to \(lqmy prompt string\(rq, set $B<MANLESS> to \(oqB<-Psmy\ prompt\ string>\(cq.  Using the B<-r> option overrides this environment variable.
ru: Если установлена переменная окружения $B<MANLESS>, то её значение будет использоваться по умолчанию как строка приглашения для пейджера B<less>, как если бы был указан параметр B<-r> (так что любые появления текста B<$MAN_PN> будут как-то раскрыты). Например, если вы хотите установить строку приглашения дословно в \(lqmy prompt string\(rq, то установите $B<MANLESS> равной \(oqB<-Psmy\ prompt\ string>\(cq. Указанное значение параметра B<-r> замещает значение переменной окружения.

note: type: Plain text
en: If $B<BROWSER> is set, its value is a colon-delimited list of commands, each of which in turn is used to try to start a web browser for B<man> B<--html>.  In each command, I<%s> is replaced by a filename containing the HTML output from B<groff>, I<%%> is replaced by a single percent sign (%), and I<%c> is replaced by a colon (:).
ru: Если установлена переменная окружения $B<BROWSER>, то её значение представляет собой список команд, разделяемых двоеточием; каждая из них используется для попытки запуска веб-браузера для B<man> B<--html>. В каждой команде I<%s> заменяется именем файла, содержащим HTML результат от B<groff>, I<%%> заменяется одним знаком процента (%), а I<%c> заменяется двоеточием (:).

note: type: Plain text
en: If $B<MANOPT> is set, it will be parsed prior to B<%man%'s> command line and is expected to be in a similar format.  As all of the other B<%man%> specific environment variables can be expressed as command line options, and are thus candidates for being included in $B<MANOPT> it is expected that they will become obsolete.  N.B.  All spaces that should be interpreted as part of an option's argument must be escaped.
ru: Если установлена переменная окружения $B<MANOPT>, то она анализируется раньше командной строки B<%man%> и должна задаваться в том же формате. Значения всех специальных переменных окружения B<%man%> могут быть заданы в параметрах командной строки, а включение в $B<MANOPT> показывает, что данный параметр скоро устареет. Обратите особое внимание на то, что все пробелы, которые должны быть частью значения параметра, нужно экранировать.

note: type: Plain text
en: If $B<MANWIDTH> is set, its value is used as the line length for which manual pages should be formatted.  If it is not set, manual pages will be formatted with a line length appropriate to the current terminal (using the value of $B<COLUMNS>, and B<ioctl>(2)  if available, or falling back to 80 characters if neither is available).  Cat pages will only be saved when the default formatting can be used, that is when the terminal line length is between 66 and 80 characters.
ru: Если установлена переменная окружения $B<MANWIDTH>, то её значение используется в качестве длины строки форматируемых справочных страниц. Если она не установлена, то справочные страницы будут отформатированы по длине строки текущего терминала (используется значение переменной $B<COLUMNS>, и вызов B<ioctl>(2), если он доступен, или 80 символов, если ничего недоступно). Cat страницы будут сохраняться на диск только, если может быть использовано форматирование по умолчанию, то есть когда длина строки терминала лежит в промежутке между 66 и 80 символами.

note: type: Plain text
en: Normally, when output is not being directed to a terminal (such as to a file or a pipe), formatting characters are discarded to make it easier to read the result without special tools.  However, if $B<MAN_KEEP_FORMATTING> is set to any non-empty value, these formatting characters are retained.  This may be useful for wrappers around B<%man%> that can interpret formatting characters.
ru: Обычно, если вывод не направляется на терминал (например, в файл или канал), символы форматирования отбрасываются для облегчения чтения результата не имея специальных инструментов. Однако, если переменная окружения $B<MAN_KEEP_FORMATTING> установлена в непустое значение, то символы форматирования остаются. Это может быть полезно для оболочек вокруг B<%man%>, которые распознают символы форматирования.

note: type: Plain text
en: Normally, when output is being directed to a terminal (usually to a pager), any error output from the command used to produce formatted versions of manual pages is discarded to avoid interfering with the pager's display.  Programs such as B<groff> often produce relatively minor error messages about typographical problems such as poor alignment, which are unsightly and generally confusing when displayed along with the manual page.  However, some users want to see them anyway, so, if $B<MAN_KEEP_STDERR> is set to any non-empty value, error output will be displayed as usual.
ru: Обычно, если вывод направляется на терминал (например, в пейджер), все ошибки вывода команды, используемой для создания форматированного варианта справочной страницы, отбрасываются во избежании порчи отображаемого текста. Программы типа B<groff> часто выводят относительно безобидные сообщения об ошибках, например о печатных проблемах плохого выравнивания вперемешку с информацией справочной страницы. Однако, некоторые пользователи всё равно хотели бы их видеть, и поэтому, если установить переменную окружения $B<MAN_KEEP_STDERR> в непустое значение, вывод ошибок будет производиться как обычно.

note: type: Plain text
en: On Linux, B<%man%> normally confines subprocesses that handle untrusted data using a B<seccomp>(2)  sandbox.  This makes it safer to run complex parsing code over arbitrary manual pages.  If this goes wrong for some reason unrelated to the content of the page being displayed, you can set $B<MAN_DISABLE_SECCOMP> to any non-empty value to disable the sandbox.
ru: В Linux, B<%man%>, обычно, ограничивает подпроцессы, работающие с ненадёжными данными, с помощью изолированной среды B<seccomp>(2). Это позволяет безопасно запускать сложный код разбора произвольных справочных страниц. Если это приводит к ошибке по причине не связанной с содержимым отображаемой справочной страницы, то изолированную среду можно отключить, указав непустое значение в переменной $B<MAN_DISABLE_SECCOMP>.

note: type: Plain text
en: If the $B<PIPELINE_DEBUG> environment variable is set to "1", then B<%man%> will print debugging messages to standard error describing each subprocess it runs.
ru: Если переменная окружения $B<PIPELINE_DEBUG> равна «1», то B<%man%> выведет отладочные сообщения в стандартный поток ошибок из каждого запускаемого подпроцесса.

note: type: Plain text
en: Depending on system and implementation, either or both of $B<LANG> and $B<LC_MESSAGES> will be interrogated for the current message locale.  B<%man%> will display its messages in that locale (if available).  See B<setlocale>(3)  for precise details.
ru: В зависимости от системы и реализации, одна или обе переменные $B<LANG> и $B<LC_MESSAGES> будут просмотрены для определения текущей локали сообщений. B<%man%> будет отображать свои сообщения в этой локали (если они для неё есть). Подробней смотрите в B<setlocale>(3).

note: type: Plain text
en: man-db configuration file.
ru: Файл настройки man-db.

note: type: Plain text
en: A global manual page hierarchy.
ru: Глобальная иерархия справочных страниц.

note: type: Plain text
en: Documentation for some packages may be available in other formats, such as B<info>(1)  or HTML.
ru: Документация на некоторые пакеты может быть доступна в других форматах, например, B<info>(1) или HTML.

note: type: SH
en: HISTORY
ru: ИСТОРИЯ

note: type: Plain text
en: 1990, 1991 \(en Originally written by John W.\& Eaton (jwe@che.utexas.edu).
ru: 1990, 1991 \(en изначально написана Джоном В.\& Итоном (John W. Eaton, jwe@che.utexas.edu).

note: type: Plain text
en: Dec 23 1992: Rik Faith (faith@cs.unc.edu) applied bug fixes supplied by Willem Kasdorp (wkasdo@nikhefk.nikef.nl).
ru: 23 декабря 1992: Рик Фейт (Rik Faith, faith@cs.unc.edu) исправил ошибки, найденные Виллемом Касдорпом (Willem Kasdorp, wkasdo@nikhefk.nikef.nl).

note: type: Plain text
en: 30th April 1994 \(en 23rd February 2000: Wilf.\& (G.Wilford@ee.surrey.ac.uk)  has been developing and maintaining this package with the help of a few dedicated people.
ru: 30 апреля 1994 \(en 23 февраля 2000: Вильф (Wilf.\& G.Wilford@ee.surrey.ac.uk) разрабатывал и сопровождал этот пакет с помощью некоторых других людей.

note: type: Plain text
en: 30th October 1996 \(en 30th March 2001: Fabrizio Polacco E<lt>fpolacco@debian.orgE<gt> maintained and enhanced this package for the Debian project, with the help of all the community.
ru: 30 октября 1996 \(en 30 марта 2001: Фабрицио Полако (Fabrizio Polacco, E<lt>fpolacco@debian.orgE<gt> сопровождал и улучшал этот пакет для проекта Debian с помощью всего сообщества.

note: type: Plain text
en: 31st March 2001 \(en present day: Colin Watson E<lt>cjwatson@debian.orgE<gt> is now developing and maintaining man-db.
ru: 31 марта 2001 \(en настоящие дни: Колин Уотсон (Colin Watson, E<lt>cjwatson@debian.orgE<gt> занимается разработкой и сопровождением man-db.

note: type: Plain text
en: %man_recode% - convert manual pages to another encoding
ru: %man_recode% - изменяет кодировку справочных страниц

note: type: Plain text
en: B<%man_recode%> B<-t> I<to-code> {\|B<--suffix=>I<suffix\/>\||\|B<--in-place>\|} [\|B<-dqhV>\|] [\|I<filename>\|]
ru: B<%man_recode%> B<-t> I<конечная-кодировка> {\|B<--suffix=>I<суффикс\/>\||\|B<--in-place>\|} [\|B<-dqhV>\|] [\|I<имя-файла>\|]

note: type: Plain text
en: B<%man_recode%> converts multiple manual pages from one encoding to another, guessing the appropriate input encoding for each one.  It is useful when permanently recoding pages written in legacy character sets, or in build systems that need to recode a set of pages to a single common encoding (usually UTF-8) for installation.  When converting many manual pages, this program is much faster than running B<%man% --recode> or B<%manconv%> on each page.
ru: Программа B<%man_recode%> преобразует кодировку у нескольких справочных страниц, определяя входную кодировку каждой страницы. Это полезно в случае, когда нужно навсегда преобразовать страницы, использующих устаревший набор символов, или для сборки системы, в которой требуется привести набор страниц к единой кодировке (обычно, UTF-8) для установки. При преобразовании нескольких справочных страниц эта программа работает намного быстрее чем выполнение B<%man% --recode> или B<%manconv%> для каждой страницы отдельно.

note: type: Plain text
en: If an encoding declaration is found on the first line of a manual page, then that declaration is used as the input encoding for that page.  Failing that, the input encoding is guessed based on the file name.
ru: Если объявление кодировки найдено в первой строке справочной страницы, то это значение используется в качестве начальной кодировки этой страницы. При отсутствии начальная кодировка определяется из имени файла.

note: type: Plain text
en: Encoding declarations have the following form:
ru: Объявления кодировки имеют следующий формат:

note: type: Plain text
en: or (if manual page preprocessors are also to be declared):
ru: или (если для справочной страницы также указаны препроцессоры):

note: type: TP
en: B<-t> I<encoding\/>, B<--to-code=>I<encoding>
ru: B<-t> I<кодировка\/>, B<--to-code> I<кодировка>

note: type: Plain text
en: Convert manual pages to I<encoding>.
ru: Преобразовать справочные страницы в указанную I<кодировку>.

note: type: TP
en: B<--suffix=>I<suffix>
ru: B<--suffix=>I<суффикс>

note: type: Plain text
en: Form each output file name by appending I<suffix> to the input file name, after removing any compression extension.
ru: Формирует имя каждого выходного файла добавлением I<суффикса> к имени входного файла после удаления из имени расширения сжатия.

note: type: Plain text
en: Overwrite each input file with the output, after removing any compression extension.
ru: Перезаписывает каждый входной файл выходным после удаления из имени расширения сжатия.

note: type: Plain text
en: Do not issue error messages when the page cannot be converted.
ru: Не показывать сообщения об ошибках, если кодировка страницы не может быть изменена.

note: type: Plain text
en: %manconv% - convert manual page from one encoding to another
ru: %manconv% - изменяет кодировку справочной страницы

note: type: Plain text
en: B<%manconv%> B<-f> [\|I<from-code>\|[:I<from-code>\|.\|.\|.]\|] B<-t> I<to-code> [\|B<-dqhV>\|] [\|I<filename>\|]
ru: B<%manconv%> B<-f> [\|I<начальная-кодировка>\|[:I<начальная-кодировка>\|.\|.\|.]\|] B<-t> I<конечная-кодировка> [\|B<-dqhV>\|] [\|I<имя-файла>\|]

note: type: Plain text
en: B<%manconv%> converts a manual page from one encoding to another, like B<iconv>.  Unlike B<iconv>, it can try multiple possible input encodings in sequence.  This is useful for manual pages installed in directories without an explicit encoding declaration, since they may be in UTF-8 or in a legacy character set.
ru: B<%manconv%> изменяет кодировку справочной страницы, почти как B<iconv>. В отличие от B<iconv>, можно указать несколько возможных начальных кодировок. Это полезно, если справочные страницы установлены в каталогах без явного объявления кодировки, так как они могут быть в UTF-8 или в какой-то устаревшей кодировке.

note: type: Plain text
en: If an encoding declaration is found on the first line of the manual page, that declaration overrides any input encodings specified on B<%manconv%>'s command line.  Encoding declarations have the following form:
ru: Если объявление кодировки найдено в первой строке справочной страницы, то это значение заменяет любые начальные кодировки, указанные в командной строке запуска B<%manconv%>. Объявление кодировки имеет следующую форму:

note: type: TP
en: B<-f> I<encodings>, B<--from-code> I<encodings>
ru: B<-f> I<кодировки>, B<--from-code> I<кодировки>

note: type: Plain text
en: Try each of I<encodings> (a colon-separated list) in sequence as the input encoding.  The default is to guess likely input encodings based on the file name.
ru: Попытаться применить каждую I<кодировку> (список значений через двоеточие) по порядку в качестве начальной. По умолчанию входные кодировки определяются из имени файла.

note: type: TP
en: B<-t> I<encoding>, B<--to-code> I<encoding>
ru: B<-t> I<кодировка>, B<--to-code> I<кодировка>

note: type: Plain text
en: Convert the manual page to I<encoding>.
ru: Преобразовать текст справочной страницы в указанную I<кодировку>.

note: type: Plain text
en: %manpath% - determine search path for manual pages
ru: %manpath% - определяет путь поиска справочных страниц

note: type: Plain text
en: B<%manpath%> [\|B<-qgdc?V>\|] [\|B<-m> I<system>\|[\|,.\|.\|.\|]\|] [\|B<-C> I<file>\|]
ru: B<%manpath%> [\|B<-qgdc?V>\|] [\|B<-m> I<система>\|[\|,.\|.\|.\|]\|] [\|B<-C> I<файл>\|]

note: type: Plain text
en: If $B<MANPATH> is set, B<%manpath%> will simply display its contents and issue a warning.  If not, B<%manpath%> will determine a suitable manual page hierarchy search path and display the results.
ru: Если установлена переменная окружения $B<MANPATH>, то B<%manpath%> просто покажет её значение и выдаст предупреждение. Если нет, то B<%manpath%> определит подходящий путь поиска иерархии справочных страниц и отобразит результаты.

note: type: Plain text
en: The colon-delimited path is determined using information gained from the man-db configuration file \(en (I<%manpath_config_file%>)  and the user's environment.
ru: Список путей поиска (через двоеточие) определяется по данным файла настройки man-db (I<%manpath_config_file%>) и пользовательского окружения.

note: type: Plain text
en: Do not issue warnings.
ru: Не выдавать предупреждения.

note: type: Plain text
en: Produce a catpath as opposed to a manpath.  Once the manpath is determined, each path element is converted to its relative catpath.
ru: Вывести catpath, а не manpath. После того, как определён manpath, каждый элемент преобразуется в соответствующий catpath.

note: type: Plain text
en: Produce a manpath consisting of all paths named as "global" within the man-db configuration file.
ru: Вывести manpath, состоящий из всех путей, отмеченных как «глобальные» в файле настройки man-db.

note: type: Plain text
en: If this system has access to other operating systems' manual hierarchies, this option can be used to include them in the output of B<%manpath%>.  To include NewOS's manual page hierarchies use the option B<-m> B<NewOS>.
ru: Если эта система имеет доступ к иерархиям справочных страниц других операционных систем, то с помощью этого параметра можно включить их в вывод B<%manpath%>. Чтобы включить иерархии справочных страниц для операционной системы NewOS, укажите B<-m> B<NewOS>.

note: type: Plain text
en: The I<system> specified can be a combination of comma delimited operating system names.  To include the native operating system's manual page hierarchies, the system name B<man> must be included in the argument string.  This option will override the $B<SYSTEM> environment variable.
ru: В значении I<система> можно указать несколько названий операционных систем через запятую. Чтобы включить иерархии родной операционной системы, в значение параметра нужно добавить системное название B<man>. Этот параметр заменяет значение переменной окружения $B<SYSTEM>.

note: type: Plain text
en: If $B<MANPATH> is set, B<%manpath%> displays its value rather than determining it on the fly.
ru: Если задана переменная $B<MANPATH>, то B<%manpath%> выведет её значение, а не будет определять её в процессе работы.

note: type: Plain text
en: %whatis% - display one-line manual page descriptions
ru: %whatis% - показывает однострочные описания справочных страниц

note: type: Plain text
en: B<%whatis%> [\|B<-dlv?V>\|] [\|B<-r>\||\|B<-w>\|] [\|B<-s> I<list>\|] [\|B<-m> I<system>\|[\|,.\|.\|.\|]\|] [\|B<-M> I<path>\|] [\|B<-L> I<locale>\|] [\|B<-C> I<file>\|] I<name> \&.\|.\|.
ru: B<%whatis%> [\|B<-dlv?V>\|] [\|B<-r>\||\|B<-w>\|] [\|B<-s> I<список>\|] [\|B<-m> I<система>\|[\|,.\|.\|.\|]\|] [\|B<-M> I<путь>\|] [\|B<-L> I<локаль>\|] [\|B<-C> I<файл>\|] I<название> \&.\|.\|.

note: type: Plain text
en: Each manual page has a short description available within it.  B<%whatis%> searches the manual page names and displays the manual page descriptions of any I<name> matched.
ru: В начале каждой справочной страницы есть её краткое описание. B<%whatis%> осуществляет поиск в названиях справочных страниц и отображает описания всех страниц, подходящих под I<название>.

note: type: Plain text
en: I<name> may contain wildcards (B<-w>)  or be a regular expression (B<-r>).  Using these options, it may be necessary to quote the I<name> or escape (\e) the special characters to stop the shell from interpreting them.
ru: В I<названии> могут содержаться шаблоны (B<-w>) или это может быть регулярное выражение (B<-r>). При использовании этих параметров, может потребоваться указывать I<название> в кавычках или экранировать (\e) специальные символы для того, чтобы оболочка командной строки не обрабатывала их.

note: type: Plain text
en: B<index> databases are used during the search, and are updated by the B<%mandb%> program.  Depending on your installation, this may be run by a periodic cron job, or may need to be run manually after new manual pages have been installed.  To produce an old style text B<whatis> database from the relative B<index> database, issue the command:
ru: При поиске используются B<индексные> базы данных, которые обновляются с помощью программы B<%mandb%>. Для обновления баз в зависимости от установки, её можно периодически запускать из задания cron или вручную после установки новых справочных страниц. Чтобы создать текстовую базу данных B<whatis> старого формата из соответствующей B<индексной> базы, выполните команду:

note: type: Plain text
en: where I<manpath> is a manual page hierarchy such as I</usr/man>.
ru: где I<manpath> — иерархия справочных страниц, например I</usr/man>.

note: type: Plain text
en: Interpret each I<name> as a regular expression.  If a I<name> matches any part of a page name, a match will be made.  This option causes B<%whatis%> to be somewhat slower due to the nature of database searches.
ru: Рассматривать каждое I<название> как регулярное выражение. Если I<название> совпадает с любой частью имени страницы, то совпадение считается произошедшим. Этот параметр вызывает замедление работы B<%whatis%> из-за применяемого алгоритма поиска в базе.

note: type: Plain text
en: Interpret each I<name> as a pattern containing shell style wildcards.  For a match to be made, an expanded I<name> must match the entire page name.  This option causes B<%whatis%> to be somewhat slower due to the nature of database searches.
ru: Рассматривать каждое I<название> как шаблон, содержащий символы подстановки в стиле интерпретатора командной строки. Для получения совпадения, раскрытое I<название> должно полностью совпадать с именем страницы. Этот параметр вызывает замедление работы B<%whatis%> из-за применяемого алгоритма поиска в базе.

note: type: Plain text
en: If this system has access to other operating systems' manual page names, they can be accessed using this option.  To search NewOS's manual page names, use the option B<-m> B<NewOS>.
ru: Если система имеет доступ к названиям справочных страниц других операционных систем, то с помощью этого параметра среди них тоже можно осуществлять поиск. Чтобы искать в названиях справочных страниц для операционной системы NewOS, укажите B<-m> B<NewOS>.

note: type: Plain text
en: The I<system> specified can be a combination of comma delimited operating system names.  To include a search of the native operating system's manual page names, include the system name B<man> in the argument string.  This option will override the $B<SYSTEM> environment variable.
ru: В значении I<система> можно указать несколько имён операционных систем через запятую. Чтобы включить поиск в именах страниц для родной операционной системы, укажите в значении системное название B<man>. Этот параметр заменяет значение переменной окружения $B<SYSTEM>.

note: type: Plain text
en: %zsoelim% - satisfy .so requests in roff input
ru: %zsoelim% - выполняет .so запросы для входящих данных roff

note: type: Plain text
en: B<%zsoelim%> [\|B<-CVh>\|] [\|I<file> \&.\|.\|.\|]
ru: B<%zsoelim%> [\|B<-CVh>\|] [\|I<файл> \&.\|.\|.\|]

note: type: Plain text
en: B<%zsoelim%> parses I<file> arguments, or if none are specified, its standard input for lines of the form:
ru: B<%zsoelim%> анализирует параметры I<файл> или, если ничего не указано, строки из стандартного входного потока в виде:

note: type: Plain text
en: B<.so> E<lt>\|I<filename>\|E<gt>
ru: B<.so> E<lt>\|I<имя файла>\|E<gt>

note: type: Plain text
en: These requests are replaced by the contents of the I<filename> specified.  If the request cannot be met, B<%zsoelim%> looks for I<filename.ext> where I<.ext> can be one of B<.gz>, B<.Z> or B<.z>.  Other extension types may be supported depending upon compile time options.  If the request can be met by a compressed file, this file is decompressed using an appropriate decompressor and its output is used to satisfy the request.
ru: Эти запросы заменяются содержимым указанного I<файла>. Если запрос не может быть удовлетворён, то B<%zsoelim%> ищет I<имя_файла.расширение>, где I<.расширение> может быть одним из B<.gz>, B<.Z> или B<.z>. Могут поддерживаться другие типы расширений в зависимости от параметров компиляции программы. Если запрос решён с помощью сжатого файла, то данный файл расжимается с помощью соответствующей программы, и результат используется для удовлетворения запроса.

note: type: Plain text
en: Traditionally, B<soelim> programs were used to allow roff preprocessors to be able to preprocess the files referred to by the requests.  This particular version was written to circumvent problems created by support for compressed manual pages.
ru: Обычно, B<soelim>-программы используются, чтобы позволить препроцессорам roff обрабатывать файлы, указанные в запросах. Данная версия была написана, чтобы обойти проблемы, созданные поддержкой сжатых справочных страниц.

note: type: Plain text
en: This flag is available for compatibility with other B<soelim> programs.  Its use is to enable .so requests followed by something other than whitespace.  As this is already the default behaviour, it is ignored.
ru: Данный параметр введён для совместимости с другими программами B<soelim>. Он позволяет использовать для отделения имени файла в .so запросах символы, отличные от пробелов. Так как это является поведением по умолчанию, то данный параметр игнорируется.

note: type: Plain text
en: manpath - format of the %manpath_config_file% file
ru: manpath - формат файла %manpath_config_file%

note: type: Plain text
en: The manpath configuration file is used by the manual page utilities to assess users' manpaths at run time, to indicate which manual page hierarchies (manpaths) are to be treated as system hierarchies and to assign them directories to be used for storing cat files.
ru: Файл настройки manpath используется утилитами справочных страниц для доступа к пользовательским manpath во время работы; в нём определено какие иерархии справочных страниц (manpath) считать системными иерархиями, а также для них назначены каталоги хранения cat файлов.

note: type: Plain text
en: If the environment variable $B<MANPATH> is already set, the information contained within %manpath_config_file% will not override it.
ru: Если установлена переменная окружения $B<MANPATH>, то информация из %manpath_config_file% использоваться не будет.

note: type: SH
en: SEARCH PATH
ru: ПУТЬ ПОИСКА

note: type: Plain text
en: By default, man-db examines the user's $B<PATH>.  For each I<path_element> found there, it adds I<manpath_element> to the search path.
ru: ПО умолчанию, man-db проверяет $B<PATH> пользователя. Для каждого найденного там I<элемента_пути>, она добавляет I<элемент_manpath> в путь поиска.

note: type: Plain text
en: If there is no B<MANPATH_MAP> line in the configuration file for a given I<path_element>, then it adds all of I<path_element/../man>, I<path_element/man>, I<path_element/../share/man>, and I<path_element/share/man> that exist as directories to the search path.
ru: Если в файле настроек нет строки B<MANPATH_MAP> для данного I<элемента_пути>, то в путь поиска добавляются I<элемент_пути/../man>, I<элемент_пути/man>, I<элемент_пути/../share/man> и I<элемент_пути/share/man>, если они существуют в виде каталогов.

note: type: Plain text
en: It then adds any B<MANDATORY_MANPATH> entries from the configuration file to the search path.
ru: После этого в путь поиска добавляются все элементы B<MANDATORY_MANPATH> из файла настроек.

note: type: Plain text
en: Finally, if the B<--systems> option is used or the $B<SYSTEM> environment variable is set, then that should consist of a sequence of operating system names separated by commas or colons.  This acts as a template, expanding the search path once more to allow access to other operating systems' manual pages: for each system name, man-db looks for that name as a subdirectory of each entry in the search path, and adds it to the final search path if it exists.  A system name of B<man> inserts the normal search path without subdirectories.  For example, if the search path would otherwise have been I</usr/share/man:/usr/local/man>, and $B<SYSTEM> is set to I<newOS:man>, then the final search path will be I</usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man>.
ru: И, наконец, если указан параметр B<--systems> или задана переменная окружения $B<SYSTEM>, то они должны состоять из последовательности имён операционных систем, разделённых запятыми или двоеточиями. Их значения служат шаблонами, расширяющими путь поиска ещё больше, предоставляя доступ к справочным страницам других операционных систем: для каждого имени системы, man-db ищет подкаталог с таким именем в каждом элементе пути поиска, и если он существует, то добавляет его в окончательный путь поиска. Системное имя B<man> вставляется в обычный путь поиска без подкаталогов. Например. если имеется путь поиска I</usr/share/man:/usr/local/man>, и $B<SYSTEM> равна I<newOS:man>, то окончательный путь поиска будет I</usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man>.

note: type: Plain text
en: The $B<MANPATH> environment variable overrides man-db's default manual page search paths.  Most users should not need to set it.  Its syntax is similar to the $B<PATH> environment variable: it consists of a sequence of directory names separated by colons.  It overrides the default search path described above.
ru: Переменная окружения $B<MANPATH> заменяет в man-db пути поиска страниц по умолчанию. Большинству пользователей не требуется её задавать. Её синтаксис похож на переменную окружения $B<PATH>: значение состоит из последовательности имён каталогов, разделённых двоеточиями. Оно заменяет путь поиска по умолчанию, описанное выше.

note: type: Plain text
en: If the value of $B<MANPATH> starts with a colon, then the default search path is added at its start.  If the value of $B<MANPATH> ends with a colon, then the default search path is added at its end.  If the value of $B<MANPATH> contains a double colon (B<::>), then the default search path is inserted in the middle of the value, between the two colons.
ru: Если значение $B<MANPATH> начинается с двоеточия, то оно добавляется в конец пути поиска по умолчанию. Если значение $B<MANPATH> оканчивается двоеточием, то оно добавляется в начало пути поиска по умолчанию. Если значение $B<MANPATH> содержит два двоеточия подряд (B<::>), то путь поиска по умолчанию вставляется в середину значения между этими двоеточиями.

note: type: SH
en: FORMAT
ru: ФОРМАТ

note: type: Plain text
en: The following field types are currently recognised:
ru: В данный момент распознаются следующие типы полей:

note: type: TP
en: B<#>I<\ comment>
ru: B<#>I<\ комментарий>

note: type: Plain text
en: Blank lines or those beginning with a B<#> will be treated as comments and ignored.
ru: Пустые или начинающиеся с B<#> строки считаются комментариями и игнорируются.

note: type: TP
en: B<MANDATORY_MANPATH>I<\ manpath_element>
ru: B<MANDATORY_MANPATH>I<\ manpath_элемент>

note: type: Plain text
en: Lines of this form indicate manpaths that every automatically generated $B<MANPATH> should contain.  This will typically include I</usr/man>.
ru: Строки в этом формате содержат manpath, которые каждый раз генерируются автоматически для включения в $B<MANPATH>. Обычно, сюда включается I</usr/man>.

note: type: TP
en: B<MANPATH_MAP>I<\ path_element\ manpath_element>
ru: B<MANPATH_MAP>I<\ элемент_пути\ manpath_элемент>

note: type: Plain text
en: Lines of this form set up $B<PATH> to $B<MANPATH> mappings.  For each I<path_element> found in the user's $B<PATH>, I<manpath_element> will be added to the $B<MANPATH>.
ru: Строки в этом формате содержат отображение $B<PATH> в $B<MANPATH>. Для каждого I<элемента_пути>, найденного в пользовательском $B<PATH>, в $B<MANPATH> будет добавляться I<manpath_элемент>.

note: type: TP
en: B<MANDB_MAP >I<manpath_element >\|[\| I<catpath_element> \|]
ru: B<MANDB_MAP >I<manpath_элемент >\|[\| I<catpath_элемент> \|]

note: type: Plain text
en: Lines of this form indicate which manpaths are to be treated as system manpaths, and optionally where their cat files should be stored.  This field type is particularly important if B<man> is a setuid program, as (when in the system configuration file %manpath_config_file% rather than the per-user configuration file .manpath)  it indicates which manual page hierarchies to access as the setuid user and which as the invoking user.
ru: Строки в этом формате определяют, какие manpath должны считаться системными manpath, а также можно задать для каких из них нужно хранить cat файлы. Этот тип поля особенно важен, если B<man> является setuid программой, так как (когда задаются в системном файле настройки %manpath_config_file%, а не в персональном файле настройки пользователя .manpath) им определяется, к каким иерархиям справочных страниц имеет доступ setuid пользователь, а какие вызываются из-под обычного пользователя.

note: type: Plain text
en: The system manual page hierarchies are usually those stored under I</usr> such as I</usr/man>, I</usr/local/man> and I</usr/X11R6/man>.
ru: Системные иерархии справочных страниц обычно хранятся в подкаталогах I</usr>, например, I</usr/man>, I</usr/local/man> и I</usr/X11R6/man>.

note: type: Plain text
en: If cat pages from a particular I<manpath_element> are not to be stored or are to be stored in the traditional location, I<catpath_element> may be omitted.
ru: Если cat страницы из определённого I<manpath_элемента> не нужно хранить, или они будут храниться в обычном месте, то I<catpath_элемент> можно не указывать.

note: type: Plain text
en: Traditional cat placement would be impossible for read only mounted manual page hierarchies and because of this it is possible to specify any valid directory hierarchy for their storage.  To observe the B<Linux FSSTND> the keyword B<FSSTND> can be used in place of an actual directory.
ru: Традиционное размещение cat страниц было бы невозможным для смонтированных только на чтение каталогов иерархий справочных страниц, и поэтому возможно определить любую рабочую иерархию каталогов для их хранения. Допустимый каталог можно найти поиском в B<Linux FSSTND> по ключевому слову B<FSSTND>.

note: type: Plain text
en: Unfortunately, it is necessary to specify B<all> system man tree paths, including alternate operating system paths such as I</usr/man/sun> and any B<NLS locale> paths such as I</usr/man/de_DE.88591>.
ru: К сожалению, требуется указать B<все> пути системных справочных страниц, включая пути альтернативных операционных систем, такие как I</usr/man/sun> и все пути B<локалей NLS>, например I</usr/man/de_DE.88591>.

note: type: Plain text
en: As the information is parsed line by line in the order written, it is necessary for any manpath that is a sub-hierarchy of another hierarchy to be listed first, otherwise an incorrect match will be made.  An example is that I</usr/man/de_DE.88591> must come before I</usr/man>.
ru: Так как информация обрабатывается последовательно строка за строкой в порядке хранения, необходимо все manpath, которые являются субиерархиями другой иерархии, указывать в начале, иначе поиск может быть некорректным. Например, I</usr/man/de_DE.88591> должно быть указано раньше, чем I</usr/man>.

note: type: TP
en: B<DEFINE>I<\ key\ value>
ru: B<DEFINE>I<\ ключ\ значение>

note: type: Plain text
en: Lines of this form define miscellaneous configuration variables; see the default configuration file for those variables used by the manual pager utilities.  They include default paths to various programs (such as I<grep> and I<tbl>), and default sets of arguments to those programs.
ru: Строки в этом формате определяют различные переменные настройки; в файле настройки по умолчанию описаны переменные, которые используются утилитами пейджера справочных страниц. Они могут содержать пути по умолчанию к различным программам (например, I<grep> и I<tbl>) и параметры по умолчанию для этих программ.

note: type: TP
en: B<SECTION> I<section> .\|.\|.
ru: B<SECTION> I<раздел> .\|.\|.

note: type: Plain text
en: Lines of this form define the order in which manual sections should be searched.  If there are no B<SECTION> directives in the configuration file, the default is:
ru: Строки данного формата определяют порядок поиска в справочных разделах. Если в файле настройки директивы B<SECTION> не указаны, то по умолчанию используется:

note: type: Plain text
en: If multiple B<SECTION> directives are given, their section lists will be concatenated.
ru: Если указано несколько директив B<SECTION>, то их значения объединяются в список.

note: type: Plain text
en: If a particular extension is not in this list (say, 1mh) it will be displayed with the rest of the section it belongs to.  The effect of this is that you only need to explicitly list extensions if you want to force a particular order.  Sections with extensions should usually be adjacent to their main section (e.g. "1 1mh 8 ...").
ru: Если какого-то расширения не окажется в этом списке (например, 1mh), то страница будет показана вместе с оставшимся разделом, которому принадлежит. Смысл этого в том, что нужно указывать только расширения, для которых вы бы хотели жёстко задать определённый порядок. Разделы с расширениями, как правило, указываются рядом с их основным разделом (например, "1 1mh 8 ...").

note: type: Plain text
en: B<SECTIONS> is accepted as an alternative name for this directive.
ru: В качестве альтернативного имени этой директивы может использоваться B<SECTIONS>.

note: type: TP
en: B<MINCATWIDTH>I<\ width>
ru: B<MINCATWIDTH>I<\ ширина>

note: type: Plain text
en: If the terminal width is less than I<width>, cat pages will not be created (if missing) or displayed.  The default is 80.
ru: Если ширина терминала меньше чем I<ширина>, то cat страницы создаваться (если их нет) или отображаться не будут. Значение по умолчанию равно 80.

note: type: TP
en: B<MAXCATWIDTH>I<\ width>
ru: B<MAXCATWIDTH>I<\ ширина>

note: type: Plain text
en: If the terminal width is greater than I<width>, cat pages will not be created (if missing) or displayed.  The default is 80.
ru: Если ширина терминала больше чем I<ширина>, то cat страницы создаваться (если их нет) или отображаться не будут. Значение по умолчанию равно 80.

note: type: TP
en: B<CATWIDTH>I<\ width>
ru: B<CATWIDTH>I<\ ширина>

note: type: Plain text
en: If I<width> is non-zero, cat pages will always be formatted for a terminal of the given width, regardless of the width of the terminal actually being used.  This overrides B<MINCATWIDTH> and B<MAXCATWIDTH>.
ru: Если значение I<ширина> не равно 0, то cat страницы будут всегда форматироваться для терминала данной ширины, независимо от ширины терминала, который используется на самом деле. Это значение заменяет B<MINCATWIDTH> и B<MAXCATWIDTH>.

note: type: Plain text
en: This flag prevents B<%man%>(1)  from creating cat pages automatically.
ru: Этот параметр запрещает B<%man%>(1) автоматически создавать cat страницы.

note: type: Plain text
en: Unless the rules above are followed and observed precisely, the manual pager utilities will not function as desired.  The rules are overly complicated.
ru: Если точно не следовать правилам, описанным ранее, то утилиты пейджера справочных страниц не будут работать как ожидалось. Правила чрезмерно запутаны.

note: type: Plain text
en: accessdb - dumps the content of a man-db database in a human readable format
ru: accessdb - сбрасывает содержимое базы данных man-db в понятный человеку формат

note: type: Plain text
en: B</usr/sbin/accessdb> [\|B<-d?V>\|] [I<E<lt>index-fileE<gt>>]
ru: B</usr/sbin/accessdb> [\|B<-d?V>\|] [I<E<lt>index-файлE<gt>>]

note: type: Plain text
en: B<accessdb> will output the data contained within a man-db database in a human readable form.  By default, it will dump the data from B</var/cache/man/index.E<lt>db-typeE<gt>,> where E<lt>db-typeE<gt> is dependent on the database library in use.
ru: B<accessdb> выводит данные, содержащиеся внутри базы данных man-db в понятном человеку формате. По умолчанию, данные выводятся из файла B</var/cache/man/index.E<lt>db-typeE<gt>,> где E<lt>db-typeE<gt> зависит от используемой библиотеки базы данных.

note: type: Plain text
en: Supplying an argument to accessdb will override this default.
ru: Передача accessdb параметра заменяет это значение по умолчанию.

note: type: Plain text
en: %catman% - create or update the pre-formatted manual pages
ru: %catman% - создаёт или обновляет уже отформатированные справочные страницы

note: type: Plain text
en: B<%catman%> [\|B<-d?V>\|] [\|B<-M> I<path>\|] [\|B<-C> I<file>\|] [\|I<section>\|] \&.\|.\|.
ru: B<%catman%> [\|B<-d?V>\|] [\|B<-M> I<путь>\|] [\|B<-C> I<файл>\|] [\|I<раздел>\|] \&.\|.\|.

note: type: Plain text
en: B<%catman%> is used to create an up to date set of pre-formatted manual pages known as cat pages.  Cat pages are generally much faster to display than the original manual pages, but require extra storage space.  The decision to support cat pages is that of the local administrator, who must provide suitable directories to contain them.
ru: B<%catman%> используется для создания новейших отформатированных справочных страниц, называемых cat страницами. Cat страницы, обычно, намного быстрее отображаются, чем исходные справочные страницы, но для их хранения требуется дополнительное место. Решение о существовании определённых cat страниц принимает локальный администратор, который должен предоставить подходящие каталоги для их хранения.

note: type: Plain text
en: The options available to B<%catman%> are the manual page hierarchies and sections to pre-format.  The default hierarchies are those specified as system hierarchies in the man-db configuration file, and the default sections are either the colon-delimited contents of the environment variable $B<MANSECT> or the standard set compiled into B<%man%> if $B<MANSECT> is undefined.  Supplying B<%catman%> with a set of whitespace-delimited section names will override both of the above.
ru: В параметрах B<%catman%> задаются иерархии справочных страниц и разделы, которые должны быть отформатированы заранее. Иерархиями по умолчанию считаются системные иерархии, указанные в файле настроек man-db, а разделы по умолчанию берутся из значения переменной окружения $B<MANSECT> (список значений через двоеточие) или из значения, заданного при компиляции B<%man%>, если переменная окружения $B<MANSECT> не установлена. При указании B<%catman%> списка имён разделов через пробельный символ, он заменит оба эти значения по умолчанию.

note: type: Plain text
en: B<%catman%> makes use of the B<index> database cache associated with each hierarchy to determine which files need to be formatted.
ru: При определении файлов для форматирования по каждой иерархии B<%catman%> использует кэш базы данных B<index>.

note: type: Plain text
en: Specify an alternate colon-delimited manual page hierarchy search path.  By default, this is all paths indicated as system hierarchies in the man-db configuration file.
ru: Задаёт альтернативный путь поиска иерархии справочных страниц (указываются через двоеточие). По умолчанию, используются все пути, отмеченные как системные иерархии в файле настроек man-db.

note: type: Plain text
en: An alternate or FSSTND compliant global I<index> database cache.
ru: Альтернативный или соответствующий FSSTND, глобальный кэш базы данных I<index>.

note: type: Plain text
en: %mandb% - create or update the manual page index caches
ru: %mandb% - создаёт или обновляет кэши index справочных страниц

note: type: Plain text
en: B<%mandb%> [\|B<-dqsucpt?V>\|] [\|B<-C> I<file>\|] [\|I<manpath>\|]
ru: B<%mandb%> [\|B<-dqsucpt?V>\|] [\|B<-C> I<файл>\|] [\|I<manpath>\|]

note: type: Plain text
en: B<%mandb%> [\|B<-dqsut>\|] [\|B<-C> I<file>\|] B<-f> I<filename>\ .\|.\|.
ru: B<%mandb%> [\|B<-dqsut>\|] [\|B<-C> I<файл>\|] B<-f> I<имя_файла>\ .\|.\|.

note: type: Plain text
en: B<%mandb%> is used to initialise or manually update B<index> database caches.  The caches contain information relevant to the current state of the manual page system and the information stored within them is used by the man-db utilities to enhance their speed and functionality.
ru: B<%mandb%> используется для инициализации или ручного обновления кэшей базы данных B<index>. В кэшах содержится информация о текущем состоянии системы справочных страниц, а хранящаяся в них информация используется утилитами man-db для повышения скорости работы и функциональности.

note: type: Plain text
en: When creating or updating an B<index>, B<%mandb%> will warn of bad ROFF .so requests, bogus manual page filenames and manual pages from which the B<whatis> cannot be parsed.
ru: При создании или обновлении B<index>, B<%mandb%> предупреждает о неверных запросах ROFF .so, фиктивных именах файлов справочных страниц и справочных страницах, которые не удалось проанализировать с помощью B<whatis>.

note: type: Plain text
en: Supplying B<%mandb%> with an optional colon-delimited path will override the internal system manual page hierarchy search path, determined from information found within the man-db configuration file.
ru: Указываемые при запуске B<%mandb%> необязательные пути (через двоеточие) заменят внутренний путь поиска иерархии системных справочных страниц, определённый из файла настроек man-db.

note: type: SH
en: DATABASE CACHES
ru: КЭШИ БАЗЫ ДАННЫХ

note: type: Plain text
en: B<%mandb%> can be compiled with support for any one of the following database types.
ru: B<%mandb%> может быть собрана с поддержкой одного из следующих типов баз данных:

note: type: tbl table
en: Name
ru: Название

note: type: tbl table
en: Async
ru: Асинхронность

note: type: tbl table
en: Filename
ru: Имя файла

note: type: tbl table
en: Yes
ru: Да

note: type: tbl table
en: No
ru: Нет

note: type: Plain text
en: Those database types that support asynchronous updates provide enhanced speed at the cost of possible corruption in the event of unusual termination.  In an unusual case where this has occurred, it may be necessary to rerun B<%mandb%> with the B<-c> option to re-create the databases from scratch.
ru: Типы баз данных, которые поддерживают асинхронные обновления, предоставляют лучшее отношение скорости к возможности повреждения в случае неожиданного прерывания работы. Если это происходит, может потребоваться перезапустить B<%mandb%> с параметром B<-c>, чтобы пересоздать базы данных с нуля.

note: type: Plain text
en: Produce no warnings.
ru: Не выдавать предупреждения.

note: type: Plain text
en: Do not spend time looking for or adding information to the databases regarding stray cats.
ru: Не тратить время на поиск или добавление информации в базы данных по stray cats.

note: type: Plain text
en: Do not spend time checking for deleted manual pages and purging them from the databases.
ru: Не тратить время на проверку удалённых справочных страниц или их вычистку из баз данных.

note: type: Plain text
en: By default, B<%mandb%> will try to update any previously created databases.  If a database does not exist, it will create it.  This option forces B<%mandb%> to delete previous databases and re-create them from scratch, and implies B<--no-purge.> This may be necessary if a database becomes corrupt or if a new database storage scheme is introduced in the future.
ru: По умолчанию, B<%mandb%> пытается обновить любые ранее созданные базы данных. Если база данных не существует, то она будет создана. Этот параметр заставляет B<%mandb%> удалить имеющиеся базы данных и пересоздать их с нуля, и заключает в себе B<--no-purge.> Это может быть необходимо при повреждении базы данных, или если в будущем будет использоваться новая схема хранения базы данных.

note: type: Plain text
en: Create user databases only, even with write permissions necessary to create system databases.
ru: Создать только пользовательские базы данных, даже имея права на запись, необходимые для создания системных баз данных.

note: type: Plain text
en: Perform correctness checks on manual pages in the hierarchy search path.  With this option, B<%mandb%> will not alter existing databases.
ru: Выполнить проверку на правильность справочных страниц в иерархическом пути поиска. При указании этого параметра B<%mandb%> не изменяет существующие базы данных.

note: type: Plain text
en: Update only the entries for the given filename.  This option is not for general use; it is used internally by B<%man%> when it has been compiled with the B<MAN_DB_UPDATES> option and finds that a page is out of date.  It implies B<-p> and disables B<-c> and B<-s>.
ru: Обновить записи только для заданного файла. Этот параметр не для повседневного использования; он используется для служебных целей B<%man%>, когда она собрана с параметром B<MAN_DB_UPDATES> и обнаруживает, что страница устарела. Это подразумевает B<-p> и выключает B<-c> и B<-s>.

note: type: Plain text
en: Show the usage message, then exit.
ru: Показать это справочное сообщение и закончить работу.

note: type: Plain text
en: Show the version, then exit.
ru: Показать версию и закончить работу.

note: type: Plain text
en: Usage, syntax, or configuration file error.
ru: Ошибка при использовании, в синтаксисе или файле настроек.

note: type: Plain text
en: A child process failed.
ru: Работа процесса-потомка завершилась неудачно.

note: type: SH
en: DIAGNOSTICS
ru: ДИАГНОСТИКА

note: type: Plain text
en: The following warning messages can be emitted during database building.
ru: Во время создания базы данных могут появляться следующие предупреждения.

note: type: TP
en: B<E<lt>filenameE<gt>: whatis parse for page(sec) failed>
ru: B<E<lt>имя файлаE<gt>: ошибка анализа страниц(ы) программой whatis>

note: type: Plain text
en: An attempt to extract whatis line(s) from the given E<lt>filenameE<gt> failed.  This is usually due to a poorly written manual page, but if many such messages are emitted it is likely that the system contains non-standard manual pages which are incompatible with the man-db whatis parser.  See the B<WHATIS PARSING> section in B<lexgrog>(1)  for more information.
ru: Программа whatis пыталась извлечь строки из указанного E<lt>файлаE<gt>, но это не удалось. Обычно, эта ошибка возникает, если справочная страница плохо написана, а если таких сообщений возникает много, то, скорее всего, в системе содержатся нестандартные справочные страницы, несовместимые с анализатором man-db whatis. Более подробное описание смотрите в разделе B<ЧТО АНАЛИЗИРУЕТСЯ> на странице B<lexgrog>(1).

note: type: TP
en: B<E<lt>filenameE<gt>: is a dangling symlink>
ru: B<E<lt>имя файлаE<gt>: повисшая символическая ссылка>

note: type: Plain text
en: E<lt>filenameE<gt> does not exist but is referenced by a symbolic link.  Further diagnostics are usually emitted to identify the E<lt>filenameE<gt> of the offending link.
ru: E<lt>ФайлE<gt> не существует, но на него ссылаются по символической ссылке. При дальнейшей диагностике, обычно, появятся сообщения, указывающие на E<lt>файлE<gt> с неправильной ссылкой.

note: type: TP
en: B<E<lt>filenameE<gt>: bad symlink or ROFF `.so' request>
ru: B<E<lt>имя файлаE<gt>: неверная символическая ссылка или ROFF `.so' запрос>

note: type: Plain text
en: E<lt>filenameE<gt> is either a symbolic link to, or contains a ROFF include request to, a non existent file.
ru: E<lt>ФайлE<gt>, или указывает на символическую ссылку, или содержит ROFF include запрос на несуществующий файл.

note: type: TP
en: B<E<lt>filenameE<gt>: ignoring bogus filename>
ru: B<E<lt>имя файлаE<gt>: игнорируется фиктивное имя файла>

note: type: Plain text
en: The E<lt>filenameE<gt> may or may not be a valid manual page but its name is invalid.  This is usually due to a manual page with sectional extension E<lt>xE<gt> being put in manual page section E<lt>yE<gt>.
ru: E<lt>ФайлE<gt> может (или не может) быть допустимой справочной страницей, но это имя неправильно. Обычно, это происходит со справочными страницами, имеющими раздельческое расширение E<lt>xE<gt>, но лежащими в разделе E<lt>yE<gt>.

note: type: TP
en: B<E<lt>filename_maskE<gt>: competing extensions>
ru: B<E<lt>маска имени файлаE<gt>: конкурирующие расширения>

note: type: Plain text
en: The wildcard E<lt>filename_maskE<gt> is not unique.  This is usually caused by the existence of both a compressed and uncompressed version of the same manual page.  All but the most recent are ignored.
ru: Шаблон E<lt>маска имени файлаE<gt> не является уникальным. Обычно, это происходит из-за существования одновременно сжатой и несжатой версии одной и той же справочной страницы. Все страницы кроме самой новой игнорируются.

note: type: Plain text
en: Older locations for the database cache included:
ru: Места, где кэш базы данных находился ранее:

note: type: Plain text
en: The B<WHATIS PARSING> section formerly in this manual page is now part of B<lexgrog>(1).
ru: Прежде в этой странице был раздел B<ЧТО АНАЛИЗИРУЕТСЯ>, но теперь он перенесён в B<lexgrog>(1).
