.\" Man page for apropos .\" .\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.) .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH APROPOS 1 2024-04-05 2.12.1 "Утилиты просмотра справочных страниц" .SH НАЗВАНИЕ apropos \- поиск в именах справочных страниц и кратких описаниях .SH СИНТАКСИС \fBapropos\fP [\|\fB\-dalv?V\fP\|] [\|\fB\-e\fP\||\|\fB\-w\fP\||\|\fB\-r\fP\|] [\|\fB\-s\fP \fIсписок\fP\|] [\|\fB\-m\fP \fIсистема\fP\|[\|,.\|.\|.\|]\|] [\|\fB\-M\fP \fIпуть\fP\|] [\|\fB\-L\fP \fIлокаль\fP\|] [\|\fB\-C\fP \fIфайл\fP\|] \fIключевое слово\fP \&.\|.\|. .SH ОПИСАНИЕ Внутри каждой справочной страницы есть краткое описание о чём эта страница. \fBapropos\fP выполняет поиск \fIключевого слова\fP в этом описании. \fIКлючевое слово\fP может представлять собой регулярное выражение (\fB\-r\fP), шаблон (\fB\-w\fP) или точное искомое ключевое слово (\fB\-e\fP). При использовании этих параметров может потребоваться указывать \fIключевое слово\fP в кавычках или экранировать (\e) специальные символы для того, чтобы избежать их интерпретации оболочкой командной строки. Стандартные правила поиска позволяют искать по названию страницы и границам слова в описании. Используемая \fBapropos\fP поисковая база данных обновляется программой \fBmandb\fP. В зависимости от установки, она может запускаться как периодически выполняемое задание cron или вручную, после установки новых справочных страниц. .SH ПАРАМЕТРЫ .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Показывать отладочную информацию. .TP .if !'po4a'hide' .BR \-v ", " \-\-verbose Показывать подробные предупреждающие сообщения. .TP .if !'po4a'hide' .BR \-r ", " \-\-regex Рассматривать каждое ключевое слово как регулярное выражение. Является поведением по умолчанию. Для каждого ключевого слова будет выполнен независимый поиск в названиях страниц и описаниях. Для совпадения достаточно нахождения в одном из этих мест. Сравнение не ограничивается границами слова. .TP .if !'po4a'hide' .BR \-w ", " \-\-wildcard Рассматривать каждое ключевое слово как шаблон с символами подстановки в стиле оболочки командной строки. Для каждого ключевого слова будет выполнен независимый поиск в названиях страниц и описаниях. Если также указан параметр \fB\-\-exact\fP, то совпадением будет считаться только полное равенство раскрытого ключевого слова со всем описанием или названием страницы. Иначе сравнение ограничивается границами слова в описании. .TP .if !'po4a'hide' .BR \-e ", " \-\-exact Искать точное совпадение с названиями страниц и описаниями каждого ключевого слова. .TP .if !'po4a'hide' .BR \-a ", " \-\-and Показывать страницы, в которых найдены все указанные ключевые слова. По умолчанию отображаются страницы, в которых есть хотя бы одно ключевое слово. .TP .if !'po4a'hide' .BR \-l ", " \-\-long Не обрезать вывод по ширине терминала. Обычно, вывод обрезается по ширине терминала во избежание проблем с плохо оформленными разделами \fBНАЗВАНИЕ\fP. .TP \fB\-s\fP \fIсписок\/\fP, \fB\-\-sections=\fP\fIсписок\/\fP, \fB\-\-section=\fP\fIсписок\fP Искать только в заданном разделе справочных страниц. В \fIсписке\fP перечисляются разделы через двоеточие или запятую. Если в \fIсписке\fP указан только номер, например "3", то в выводимый список описаний войдут страницы из разделов "3", "3perl", "3x" и так далее; но если в \fIсписке\fP указано расширение, например "3perl", то будут показаны страницы только из раздела справочных страниц с этим расширением. .TP \fB\-m\fP \fIсистема\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIсистема\fP\|[\|,.\|.\|.\|] Если эта система имеет доступ к описаниям справочных страниц других операционных систем, то с помощью этого параметра среди них тоже может быть осуществлён поиск. Чтобы искать в описаниях справочных страниц по NewOS, укажите параметр \fB\-m\fP \fBNewOS\fP. В значении \fIсистемы\fP можно указать несколько названий систем, перечислив их через запятую. Чтобы включить поиск в \fBwhatis\fP\-описаниях по родной операционной системе, добавьте в значение системное название \fBman\fP. Этот параметр подменяет значение переменной окружения $\fBSYSTEM\fP. .TP \fB\-M\ \fP\fIпуть\fP,\ \fB\-\-manpath=\fP\fIпуть\fP Задать альтернативный набор каталогов (через двоеточие) иерархии справочных страниц для поиска. По умолчанию, \fBapropos\fP использует переменную окружения $\fBMANPATH\fP, если она существует и не пуста, иначе соответствующий manpath определяется на основе переменной окружения $\fBPATH\fP. Этот параметр подменяет значение переменной окружения $\fBMANPATH\fP. .TP \fB\-L\ \fP\fIлокаль\fP,\ \fB\-\-locale=\fP\fIлокаль\fP \fBapropos\fP, обычно, определяет текущую локаль с помощью вызова C\-функции \fBsetlocale\fP(3), которая исследует различные переменные окружения, возможно $\fBLC_MESSAGES\fP и $\fBLANG\fP. Для временной подмены полученного значения, используйте этот параметр, задающий \fIлокаль\fP только в \fBapropos\fP. Заметим, что это влияет только непосредственно на поиск страниц. Вывод сообщений программы, например справки, всегда будет выполняться для изначально определённой локали. .TP \fB\-C\ \fP\fIфайл\fP,\ \fB\-\-config\-file=\fP\fIфайл\fP Использовать указанный пользовательский файл настройки вместо значения по умолчанию \fI\(ti/.manpath\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Показать справочное сообщение и закончить работу. .TP .if !'po4a'hide' .B \-\-usage Показать короткое сообщение об использовании и завершить работу. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Показать информацию о версии. .SH "КОД ВЫХОДА" .TP .if !'po4a'hide' .B 0 Успешное выполнение программы. .TP .if !'po4a'hide' .B 1 Была показана справка об использовании, произошла синтаксическая ошибка или проблемы в файле настройки. .TP .if !'po4a'hide' .B 2 Ошибка при работе. .TP .if !'po4a'hide' .B 16 По запросу ничего не найдено. .SH ОКРУЖЕНИЕ .TP .if !'po4a'hide' .B SYSTEM Установка значения переменной окружения $\fBSYSTEM\fP равносильна указанию параметра \fB\-m\fP. .TP .if !'po4a'hide' .B MANPATH Если установлена переменная окружения $\fBMANPATH\fP, то она рассматривается как набор каталогов (через двоеточие) иерархии справочных страниц для использования при поиске. О том, как используется эта переменная окружения и поведение по умолчанию, смотрите раздел \fBПУТЬ ПОИСКА\fP в \fBmanpath\fP(5). .TP .if !'po4a'hide' .B MANWIDTH Если установлена переменная окружения $\fBMANWIDTH\fP, то её значение используется для определения ширины терминала (смотрите описание параметра \fB\-\-long\fP). Если она не установлена, то ширина терминала вычисляется из значения переменной окружения $\fBCOLUMNS\fP и, если доступен, вызова \fBioctl\fP(2) или устанавливается равной 80 символам, если определить значение не удалось. .TP .if !'po4a'hide' .B POSIXLY_CORRECT Если установлена переменная окружения $\fBPOSIXLY_CORRECT\fP, даже имеющая пустое значение, то по умолчанию \fBapropos\fP включает поиск по расширенным регулярным выражениям (\fB\-r\fP). В настоящее время, это всё равно является поведением по умолчанию. .SH ФАЙЛЫ .TP .if !'po4a'hide' .I /usr/share/man/index.(bt\^|\^db\^|\^dir\^|\^pag) Традиционный кэш глобальной базы данных \fIindex\fP. .TP .if !'po4a'hide' .I /var/cache/man/index.(bt\^|\^db\^|\^dir\^|\^pag) Соответствующий FHS глобальный кэш базы данных \fIindex\fP. .TP .if !'po4a'hide' .I /usr/share/man/\|.\|.\|.\|/whatis Традиционная текстовая база данных \fBwhatis\fP. .SH "СМОТРИТЕ ТАКЖЕ" .if !'po4a'hide' .BR man (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR mandb (8) .SH АВТОР .nf .if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .SH ОШИБКИ .if !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db