Экранная документация Manual Pages

Основным источником получения справочной информации являются страницы руководства Manual Pages (сокращенно — man-страницы, или просто страницы). Они вызываются следующим образом:

man имя_команды (или имя_программы)

Каждая страница начинается с имени команды (или программы) и указания на номер группы страниц, к которым она отнесена (что такое группа страниц, будет сказано чуть ниже). Далее следуют название команды с ее синонимами, если таковые имеются, и краткая справка по использованию. Например, для команды Is начало man-страницы в русскоязычном варианте выглядит следующим образом:

LS(1) LS(1)

НАЗВАНИЕ

ls, dir, vdir - программы для отображения содержимого каталога

СИНТАКСИС

ls [опции] [файл...] dir [файл...] vdir [файл...]

Опции POSIX: [-CFRacdilqrtu1] [--]

Опции GNU (краткая форма): [-1abcdfghiklmnopqrstuvwxABCD-FGHLNQRSUX] [-w cols] [-T cols] [-I шаблон] [--full-time] [--show-control-chars] [--block-size=размер] [--for-mat={long,verbose,commas,across,vertical,single-column}] [--sort={none,time,size,extension}] [--time={atime,access,use,ctime,status}] [--color[={none,auto,always}]] [--help] [--version] [--]

и так далее. Затем следует более или менее подробное описание использования команды:

ОПИСАНИЕ

Программа ls сначала выводит список всех файлов (не каталогов), перечисленных в командной строке, а затем выводит список всех файлов, находящихся в каталогах.

включая ее опции:

ОПЦИИ POSIX

-C Печатает список файлов в колонках (с вертикальной сортировкой).

В заключение, как правило, даются сведения о найденных ошибках (Bug Report) и приведен список страниц, тематически связанных с данной, с указанием номера группы, к которой они принадлежат.

Большинство страниц занимает более одного экрана. В этом случае просмотр их осуществляется либо построчно (нажатием клавиши Enter — вперед, клавиш Down и Up — вперед и назад), либо постранично (клавишей Пробел — вперед, клавишами PageDown и PageUp — соответственно, на страницу вперед и назад). Для выхода из режима просмотра страницы предусмотрена клавиша q .

Местоположение man-страниц — в каталоге /usr/share/man ; отдельные страницы man расположены также в каталогах /usr/man , /usr/local/man , /usr/X11R6/man .

Страницы разделены на восемь нумерованных групп, каждая из которых размещена в собственном подкаталоге:

/usr/share/man/manl/usr/share/man/man2

и т.д.

Назначение этих групп следующее:

1. команды и прикладные программы пользователя,

2. системные вызовы,

3. библиотечные функции,

4. специальные файлы,

5. форматы файлов и соглашения,

6. игры,

7. макропакеты,

8. команды администрирования системы.

Наибольший интерес для пользователя представляют разделы 1 и 5, хотя, как показано в«Руководстве администратора»,ему нередко придется обращаться и к разделу 8. Заметим, что разделы 2-4 предназначены в основном для разработчиков программного обеспечения.

В состав разных групп могут входить разные страницы с одним и тем же именем. Так, например, в группе 1 имеется страница tty(l), посвященная одноименной команде, а в группе 4 — страница tty(4), описывающая драйвер для устройства /dev/tty. Именно поэтому в первой строке каждой страницы указывается ее принадлежность в группе. Для вызова определенной группы последняя должна быть задана в явном виде:

man 1 tty

или

man 4 tty

При вводе команды man без номера группы имя соответствующей страницы ищется в первую очередь в группе 1, затем в группе 8, и затем — во всех остальныхв порядке возрастания номеров.

Локализованные версии страниц интерактивного руководства также расположены в каталоге /usr/share/man в собственных подкаталогах, например: de_DE — страницы руководства на немецком языке для Германии, fr_FR — франкоязычные страницы для Франции, ru — русскоязычные страницы. В дан-ныхподкаталогахстраницы также разделены на группы, идентичные главной иерархии:

/usr/share/man/ru/man1 /usr/share/man/ru/man2

При корректной установке национальной локали, например, русской (а в дистрибутивеASPLinuxесть возможность выбора рабочей локали на стадии установки системы. см.«Руководство по установке»), вызов определенной страницы приводит к замене оригинальной версии соответствующей национальной (в нашем случае — русскоязычной), если последняя имеется.

Обращение к страницам руководства позволяет получить практически исчерпывающую информацию по любым командамASPLinux, но только в том случае, если пользователь знает название команды, требующейся в данном случае. Однако, можно прибегнуть к поиску страниц по ключевым словам, отражающим ее функции. Например, команда

man -k print

выведет на экран список всехстраниц руководства, описывающихкоманды, имеющие отношение к печати:

arch (1) - print machine architecture

banner (6) - print large banner on printer

cancel (1) - send cancel requests to an LPRng print service

и т.д. (список может быть очень длинным) — с номерами ихгрупп и краткими пояснениями. Поиск по ключевым словам ведется в базе данных, которая хранится в файле /usr/share/man/whatis . Обновление базы данныхпро-изводится автоматически раз в сутки.

Исчерпывающим руководством по использованию системы Manual Pages является ее собственная man-страница. Доступ к ней осуществляется по команде

man man

которая выводит на экран описание этой команды.

Еще материалы по теме: