Provided by:
man-db_2.5.7-2_i386 
НАЗВАНИЕ
apropos - поиск в именах справочных страниц и кратких описаниях
СИНТАКСИС
apropos [-dalhvV] [-e|-w|-r] [-s ] [-m [,...]] [-M ]
[-L ] [-C ] ...
ОПИСАНИЕ
Внутри каждой справочной страницы есть краткое описание о чём эта
страница. apropos выполняет поиск в этом описании.
может представлять собой регулярное выражение (-r),
шаблон (-w) или точное искомое ключевое слово (-e). При использовании
этих параметров может потребоваться указывать в кавычках
или экранировать (\) специальные символы для того, чтобы избежать их
интерпретации оболочкой командной строки.
Стандартные правила поиска позволяют искать по названию страницы и
границам слова в описании.
Используемая apropos поисковая база данных обновляется программой
mandb. В зависимости от установки, она может запускаться как
периодически выполняемое задание cron или вручную, после установки
новых справочных страниц.
ПАРАМЕТРЫ
-d, --debug
Показывать отладочную информацию.
-v, --verbose
Показывать подробные предупреждающие сообщения.
-r, --regex
Рассматривать каждое ключевое слово как регулярное выражение.
Является поведением по умолчанию. Для каждого ключевого слова
будет выполнен независимый поиск в названиях страниц и
описаниях. Для совпадения достаточно нахождения в одном из этих
мест. Сравнение не ограничивается границами слова.
-w, --wildcard
Рассматривать каждое ключевое слово как шаблон с символами
подстановки в стиле оболочки командной строки. Для каждого
ключевого слова будет выполнен независимый поиск в названиях
страниц и описаниях. Если также указан параметр --exact, то
совпадением будет считаться только полное равенство раскрытого
ключевого слова со всем описанием или названием страницы. Иначе
сравнение ограничивается границами слова в описании.
-e, --exact
Искать точное совпадение с названиями страниц и описаниями
каждого ключевого слова.
-a, --and
Показывать страницы, в которых найдены все указанные ключевые
слова. По умолчанию отображаются страницы, в которых есть хотя
бы одно ключевое слово.
-l, --long
Не обрезать вывод по ширине терминала. Обычно, вывод обрезается
по ширине терминала во избежание проблем с плохо оформленными
разделами НАЗВАНИЕ.
-s , --section
Искать только в заданном разделе справочных страниц. Если в
указан только номер, например "3", то в выводимый список
описаний войдут страницы из разделов "3", "3perl", "3x" и так
далее; но если указан с расширением, например "3perl", то
будут показаны страницы только из этого раздела справочных
страниц.
-m [,...], --systems=[,...]
Если эта система имеет доступ к описаниям справочных страниц
других операционных систем, то с помощью этого параметра среди
них тоже может быть осуществлён поиск. Чтобы искать в описаниях
справочных страниц по NewOS, укажите параметр -m NewOS.
В значении можно указать несколько названий систем,
перечислив их через запятую. Чтобы включить поиск в
whatis-описаниях по родной операционной системе, добавьте в
значение системное название man. Этот параметр подменяет
значение переменной окружения $SYSTEM.
-M , --manpath=
Задать альтернативный набор каталогов (через двоеточие) иерархии
справочных страниц для поиска. По умолчанию, apropos использует
переменную окружения $MANPATH, если она существует и не пуста,
иначе соответствующий manpath определяется на основе переменной
окружения $PATH. Этот параметр подменяет значение переменной
окружения $MANPATH.
-L , --locale=
apropos, обычно, определяет текущую локаль с помощью вызова
C-функции setlocale(3), которая исследует различные переменные
окружения, возможно $LC_MESSAGES и $LANG. Для временной подмены
полученного значения, используйте этот параметр, задающий
только в apropos. Заметим, что это влияет только непосредственно
на поиск страниц. Вывод сообщений программы, например справки,
всегда будет выполняться для изначально определённой локали.
-C , --config-file=
Использовать указанный пользовательский файл настройки вместо
значения по умолчанию ~/.manpath.
-h, --help
Показать справочное сообщение и закончить работу.
-V, --version
Показать информацию о версии.
КОД ВЫХОДА
0 Успешное выполнение программы.
1 Была показана справка об использовании, произошла синтаксическая
ошибка или проблемы в файле настройки.
2 Ошибка при работе.
16 По запросу ничего не найдено.
ОКРУЖЕНИЕ
SYSTEM Установка значения переменной окружения $SYSTEM равносильна
указанию параметра -m.
MANPATH
Если установлена переменная окружения $MANPATH, то она
рассматривается как набор каталогов (через двоеточие) иерархии
справочных страниц для использования при поиске.
MANWIDTH
Если установлена переменная окружения $MANWIDTH, то её значение
используется для определения ширины терминала (смотрите описание
параметра --long). Если она не установлена, то ширина терминала
вычисляется, если доступно, с помощью ioctl(2) или берётся
значение переменной окружения $COLUMNS. Если определить значение
не удалось, то ширина устанавливается равной 80 символам.
POSIXLY_CORRECT
Если установлена переменная окружения $POSIXLY_CORRECT, даже
имеющая пустое значение, то по умолчанию apropos включает поиск
по расширенным регулярным выражениям (-r). В настоящее время,
это всё равно является поведением по умолчанию.
ФАЙЛЫ
/usr/share/man/index.(bt|db|dir|pag)
Традиционный кэш глобальной базы данных index.
/var/cache/man/index.(bt|db|dir|pag)
Соответствующий FHS глобальный кэш базы данных index.
/usr/share/man/.../whatis
Традиционная текстовая база данных whatis.
СМОТРИТЕ ТАКЖЕ
whatis(1), man(1), mandb(8).
АВТОР
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).