Библиотека сайта rus-linux.net
Могущественный man(ual): всегда готов прийти на помощь
Оригинал: Getting help: the powerful man(ual)
Автор: Andrew Min
Дата: 7 апреля 2008
Перевод: Александр Тарасов aka oioki
Дата перевода: 9 апреля 2008
Взглянем правде в глаза: нелегко пользоваться GNU/Linux, а особенно консольными программами. Иногда есть документация к программе, либо в комплекте с самой программой, либо на веб-сайте, но так бывает не всегда. Что же делать в таких случаях? Ответ даст волшебный man.
man: решение практически всех проблем
На заре программирования не было единообразия в программах чтения документации. Они были разбросаны во всяческих местах, не говоря уже о том, что вообще их можно было где-нибудь найти. Затем Деннисом Ритчи (создателем языка C и пионером UNIX) и Кеном Томпсоном (создателем языка B - прародителя языка C и тоже пионером UNIX) были написаны первые руководства (manuals; сокращенно man). Теперь, спустя 35 лет, практически каждая консольная программа и большинство графических содержит в своей поставке документацию в виде man-страницы.
Вы наверно сейчас подумали, "классный урок из истории, но это вряд ли мне поможет". В общем, пришло время познакомиться с программой, которая была создана специально для чтения man-страниц, и называется она man. Не стоит даже беспокоиться об ее установке (если у вас современная UNIX/Linux система, она уже установлена). Чтобы получить справку по какой-либо программе, нужно набрать в консоли man название_программы (например, man firefox). Перед вами предстанет man-страница соответствующей программы. Для навигации можно пользоваться клавишами курсора, а также клавишами Home и End. Для возврата в консоль нажмите клавишу Q. Вот так выглядит начало man-страницы программы wget:
WGET(1) GNU Wget WGET(1)
NAME
Wget - The non-interactive network downloader.
SYNOPSIS
wget [option]... [URL]...
DESCRIPTION
GNU Wget is a free utility for non-interactive download of files from
the Web. It supports HTTP, HTTPS, and FTP protocols, as well as
retrieval through HTTP proxies.
Wget is non-interactive, meaning that it can work in the background,
while the user is not logged on. This allows you to start a retrieval
and disconnect from the system, letting Wget finish the work. By con-
trast, most of the Web browsers require constant user's presence, which
can be a great hindrance when transferring a lot of data.
[...]
Рисунок 1: начало man-страницы программы wget
Yelp: просмотрщик документации в Gnome
Надо признать, что просмотрщик man немного невзрачен. Лучше использовать графический man-просмотрщик. Yelp (в некоторых дистрибутивах он именуется Help или Help and Support или Help Center) - программа такого рода в среде Gnome. На самом деле это больше, чем просто man-просмотрщик; он позволяет просматривать DocBook, man и документы infopage, а также документы FAQ. Чтобы воспользоваться им, введите имя программы (необязательно с учетом регистра) в поле поиска, и вам будет представлен список найденных результатов. Выберите нужный (например, wget). Отобразится все та же man-страница, но в более удобном для восприятия виде.
Рисунок 2: страница wget в Yelp
Центр справки KDE: Yelp для KDE
Если вы приверженец KDE, то наверняка не захотите пользоваться программой Yelp. Ее роль здесь играет Центр справки KDE (KDE Help Center). Вы просто набираете имя программы (без учета регистра) в поле поиска, отмечаете UNIX manual pages в разделе Область (Scope), и нажимаете Поиск (Search). Под заголовком Страницы руководства Unix (Unix manual pages) найдите нужную и выберите ее (например, wget - The non-interactive network downloader). Перед вами предстанет симпатичная man-страница, отрисованная Konqueror'ом.
Рисунок 3: страница wget в KDE Help Center
Konqueror: альтернативный и менее громоздкий
Лично мне Центр справки KDE кажется слегка неповоротливым. Поэтому я предпочитаю пользоваться Konqueror'ом, веб-браузером KDE и по совместительству файловым менеджером (хотя последняя роль в KDE 4 была замещена менеджером Dolphin). В конце концов, в Центре справки KDE отрисовкой man-страниц занимается именно движок Konqueror. Чтобы открыть какую-нибудь man-страницу, напишите в адресной строке man:имя_программы, причем имя программы нужно писать в нижнем регистре. Поиск можно вести, набирая man:/ и выбрав нужную страницу из предложенных разделов. На самом деле это самый быстрый и симпатичный способ получения справки, без свисточков и звоночков тяжелого Центра справки KDE.
Рисунок 4: страница wget в Konqueror
Просмотрщик man-страниц Die.net (и многие другие сайты)
Наконец, man-страницы можно читать на веб-сайтах. Есть огромное количество сайтов, но я предпочитаю пользоваться сайтом Die.net. Просто введите имя программы в поле, и Die.net предоставит список найденных соответствий. Этот способ замечателен тем, что можно просмотреть man-страницу к программе, не устанавливая программу, как в других случаях.
Рисунок 5: просмотрщик man-страниц Die.net