Man page/Navigate/ru

Это руководство показывает как передвигаться по страницам справки, используя команду man.

Программа man
Каждый использовал ее в какой-то момент своей работы в Linux. Её - команду man. В то время как программа man сама по себе кажется скорее простой в использовании, она имеет несколько дополнительных возможностей, кроме простого прокручивания страницы. Этот документ предназначен для того, чтобы пролить свет на эти возможности.

Структура страниц справки
Страницы справки в основном хранятся в каталоге. Однако, если путь к странице справки указан в переменной среды, команда man сможет ее найти. Gentoo в основном хранит переменную  в. Внутри указанных в начале каталогов расположены несколько папок со структурой manX, где X - это номер секции. Например, стандартное расположение страниц справки может выглядеть следующим образом:

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

В то время как это не самый полный и подробный список, он охватывает те страницы справки в которых заинтересовано большинство. Однако, иногда Вы можете узнать что делает тот или иной раздел просто посмотрев эту таблицу. В следующей главе рассмотрено использование команды man для прохода по этой структуре.

Просмотр структуры страниц справки
Now that we understand the man layout, we can begin to look it over for commands. Sometimes we may need to narrow down what man page we want. The first way would be addressing by section. To found out a description of a section, one can use man intro like so:

Unfortunately, this doesn't always work! However, luckily for us there is another way to search for commands that may return multiple results (such as a library call and system command having the same name). To do so, we use the  option to the man command like so:

Иногда, результат может быть намного большим. В этом случае лучшим выходом может быть указание большего количества специфических ключевых слов. Теперь, когда мы знаем где найти man-страницу, в следующей секции мы рассмотрим просмотр этих страниц.

Просмотр man-страниц
Viewing man pages can be done in 2 ways, first is with  man [man page name] . The second way is man [man page name]. Let's take for example. I can view either the first man page that comes up on bc (which would be section 1, because it is the lowest section containing a man page on bc):

Однако, что если мне нужна POSIX-версия? Тогда я могу использовать следующую форму записи.

И страница показана. Теперь, когда мы получили требуемую страницу справки, самое время с ней поработать. В следующем разделе мы рассмотрим навигацию и поиск.

Навигация и поиск по man-страницам
Navigating a man page is fairly simple. To move up and down line by line, use the and  arrow keys. To move up page by page, you can use the and  keys. Do however note that these navigation instructions assume the environmental  variable is set to use the default pager, less. Less also has a few other commands for navigation, but the arrow keys usually suffice:

Searching, however, is more interesting. The two most basic searches are  and. The first version searches forwards, and the second searches backwards. is a regular expression pattern that is described in man 7 regex. Let's take for example searching for the  option to emerge. First, bring up the emerge man page:

Затем, на экране, нажмите клавишу для вызова командной строки для поиска вперед и введите наш запрос:

Эта команда выполнит поиск на данной man-странице и сфокусируется на искомом элементе.

If you hit a search result by accident and want to continue searching for the same results, simply press the key again, and press  (i.e. don't put a pattern it). This will cause the search to default to the last pattern used. Now with some man pages, options are listed, then explained later on. Take the man 5 portage man page. It lists the files used, then explains their usage. Searching forward a few times would return the results, but there's an easier way to handle this, with the second search form, backwards searching. Let's use this to find the description on. First, bring up man 5 portage:

Теперь, нажмите +. Это перенесет вас на конец страницы:

Now we'll go ahead and enter the pattern to search for with the  backwards search option. First press the key to bring up the prompt, and then enter in, our query:

Затем нажмите для получения результата:

И поиск завершен! Заметьте то, что как и в случае с , использование поиска   без строки шаблона использует последний шаблон для поиска.

Выводы
Это завершает наше руководство по команде man. Надеемся, что это пролило некоторый свет на навигацию по страницам справки, и, может быть, даже дало несколько новых советов более опытным пользователям. Для тех, кто предпочитает альтернативные способы навигации по man-страницам, также доступно следующее:


 * — программа для конвертации man-страниц в html.
 * — просмотрщик man-страниц, основанный на tk.

Also the KDE web browser can browse man pages using the man: syntax in the address bar.