Provided by: man-db_2.5.6-2_i386 bug

НАЗВАНИЕ

       whatis - показывает описания справочных страниц

СИНТАКСИС

       whatis  [-dlhvV]  [-r|-w]  [-s ] [-m [,...]] [-M ] [-L
       ] [-C ]  ... whatis [-dlhvV] [-r|-w] [-s ]  [-m
       [,...]] [-M ] [-L ] [-C ]  ...

ОПИСАНИЕ

       В  начале  каждой  справочной страницы есть её краткое описание. whatis
       осуществляет поиск в названиях справочных страниц и отображает описания
       всех страниц, подходящих под .

       В  могут содержаться шаблоны (-w) или это может быть регулярное
       выражение (-r). При использовании этих параметров, может  потребоваться
       указывать   в кавычках или экранировать (\) специальные символы
       для того, чтобы оболочка командной строки не обрабатывала их.

       При поиске используются индексные базы данных,  которые  обновляются  с
       помощью программы mandb. Для обновления баз в зависимости от установки,
       её можно периодически запускать  из  задания  cron  или  вручную  после
       установки новых справочных страниц. Чтобы создать текстовую базу данных
       whatis старого формата из  соответствующей  индексной  базы,  выполните
       команду:

       whatis -M manpath -w '*' | sort > manpath/whatis

       где manpath -- иерархия справочных страниц, например /usr/man.

ПАРАМЕТРЫ

       -d, --debug
              Показывать отладочную информацию.

       -v, --verbose
              Показывать подробные предупреждающие сообщения.

       -r, --regex
              Рассматривать  каждое    как  регулярное выражение. Если
               совпадает с любой частью имени страницы, то  совпадение
              считается произошедшим. Этот параметр вызывает замедление работы
              whatis из-за применяемого алгоритма поиска в базе.

       -w, --wildcard
              Рассматривать каждое   как  шаблон,  содержащий  символы
              подстановки   в   стиле  интерпретатора  командной  строки.  Для
              получения  совпадения,  раскрытое     должно   полностью
              совпадать  с  именем страницы. Этот параметр вызывает замедление
              работы whatis из-за применяемого алгоритма поиска в базе.

       -l, --long
              Не обрезать вывод по ширине терминала. Обычно, вывод  обрезается
              по  ширине  терминала  во избежание проблем с плохо оформленными
              разделами НАЗВАНИЕ.

       -s , --section 
              Искать только в заданном  разделе  справочных  страниц.  Если  в
               указан только номер, например "3", то в выводимый список
              описаний войдут страницы из разделов "3", "3perl",  "3x"  и  так
              далее; но если  указан с расширением, например "3perl", то
              будут показаны  страницы  только  из  этого  раздела  справочных
              страниц.

       -m [,...], --systems=[,...]
              Если  система имеет доступ к названиям справочных страниц других
              операционных систем, то с помощью этого параметра среди них тоже
              можно  осуществлять  поиск.  Чтобы искать в названиях справочных
              страниц для операционной системы NewOS, укажите -m NewOS.

              В значении  можно  указать  несколько  имён  операционных
              систем  через запятую. Чтобы включить поиск в именах страниц для
              родной  операционной  системы,  укажите  в  значении   системное
              название   man.   Этот  параметр  заменяет  значение  переменной
              окружения $SYSTEM.

       -M , --manpath=
              Задать альтернативный набор каталогов (через двоеточие) иерархии
              справочных  страниц  для поиска. По умолчанию, whatis использует
              переменную окружения $MANPATH, если она существует и  не  пуста,
              иначе  соответствующий manpath определяется на основе переменной
              окружения $PATH. Этот  параметр  подменяет  значение  переменной
              окружения $MANPATH.

       -L , --locale=
              whatis,  обычно,  определяет  текущую  локаль  с  помощью вызова
              C-функции setlocale(3), которая исследует  различные  переменные
              окружения,  возможно $LC_MESSAGES и $LANG. Для временной подмены
              полученного значения, используйте этот параметр, задающий 
              только  в whatis. Заметим, что это влияет только непосредственно
              на поиск страниц. Вывод сообщений программы,  например  справки,
              всегда будет выполняться для изначально определённой локали.

       -C , --config-file=
              Использовать  указанный  пользовательский  файл настройки вместо
              значения по умолчанию ~/.manpath.

       -h, --help
              Показать справочное сообщение и закончить работу.

       -V, --version
              Показать информацию о версии.

КОД ВЫХОДА

       0      Успешное выполнение программы.

       1      Была показана справка об использовании, произошла синтаксическая
              ошибка или проблемы в файле настройки.

       2      Ошибка при работе.

       16     По запросу ничего не найдено.

ОКРУЖЕНИЕ

       SYSTEM Установка  значения  переменной  окружения  $SYSTEM  равносильна
              указанию параметра -m.

       MANPATH
              Если  установлена  переменная   окружения   $MANPATH,   то   она
              рассматривается  как  набор каталогов (через двоеточие) иерархии
              справочных страниц для использования при поиске.

       MANWIDTH
              Если установлена переменная окружения $MANWIDTH, то её  значение
              используется для определения ширины терминала (смотрите описание
              параметра --long). Если она не установлена, то ширина  терминала
              вычисляется,  если  доступно,  с  помощью  ioctl(2)  или берётся
              значение переменной окружения $COLUMNS. Если определить значение
              не удалось, то ширина устанавливается равной 80 символам.

ФАЙЛЫ

       /usr/share/man/index.(bt|db|dir|pag)
              Традиционный кэш глобальной базы данных index.

       /var/cache/man/index.(bt|db|dir|pag)
              Соответствующий FHS глобальный кэш базы данных index.

       /usr/share/man/.../whatis
              Традиционная текстовая база данных whatis.

СМОТРИТЕ ТАКЖЕ

       apropos(1), man(1), mandb(8).

АВТОР

       Wilf. (G.Wilford@ee.surrey.ac.uk).
       Fabrizio Polacco (fpolacco@debian.org).
       Colin Watson (cjwatson@debian.org).