|
НАЗВАНИЕ
apropos - поиск в именах справочных страниц и кратких описаниях
СИНТАКСИС
apropos [-dalv?V] [-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
Не обрезать вывод по ширине терминала. Обычно, вывод обрезается по ширине
терминала во избежание проблем с плохо оформленными разделами НАЗВАНИЕ.
-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.
-?, --help
Показать справочное сообщение и закончить работу.
--usage
Показать короткое сообщение об использовании и завершить работу.
-V, --version
Показать информацию о версии.
КОД ВЫХОДА
0 Успешное выполнение программы.
1 Была показана справка об использовании, произошла синтаксическая ошибка или
проблемы в файле настройки.
2 Ошибка при работе.
16 По запросу ничего не найдено.
ОКРУЖЕНИЕ
SYSTEM Установка значения переменной окружения $SYSTEM равносильна указанию
параметра -m.
MANPATH
Если установлена переменная окружения $MANPATH, то она рассматривается как
набор каталогов (через двоеточие) иерархии справочных страниц для
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.
СМОТРИТЕ ТАКЖЕ
man(1), whatis(1), mandb(8)
АВТОР
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
|
