Экранная документация 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-страница. Доступ к ней осуществляется по команде
Паркетная доска witex Москва.
man man
которая выводит на экран описание этой команды.
Еще материалы по теме:
- Страницы руководства man (manual)
- Mетоды работы с документацией
- Получение оперативной помощи
- Комментарии
- Итоговое краткое описание awk
- Экранная документация info
