Man page/Navigate/ru

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

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

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

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

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

Просмотр структуры страниц справки
Теперь, когда мы понимаем структуру man-страниц, мы можем начать искать команды. Иногда мы можем сосредоточиться на той man-странице, которая нам требуется. Первом способом будет поиск по разделу. Для того, чтобы найти описание раздела, можно использовать команду, как то:

К сожалению, это не всегда работает! Однако, к счастью для нас, существует другой способ поиска команд, которые могут возвращать разные результаты (такие как вызовы библиотеки и системные команды имеющие то же самое имя). Для того, чтобы это сделать, мы будем использовать параметр командной строки, как в данном случае:

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

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

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

And the man page is displayed. Now that we have the man page up, it's time to work with it. The next section will look at navigation and searching.

Navigating and searching man pages
Navigating a man page is fairly simple. To move up and down line by line, use the up and down arrow keys. To move up page by page, you can use the page up and page down keys. Do however note that these navigation instructions assume the environmental  variable is set to use the default pager,. Less also has a few other commands for navigation, but the arrow keys usually suffice:

Additional less navigation keys

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. Let's take for example searching for the  option to. First, bring up the emerge man page:

Then, at the screen, press the  key to bring up the entry prompt to search forwards and enter in our search pattern:

Bringing up the forward search prompt

This will search the man page, and bring the searched item into focus:

Forward search results

If you hit a search result by accident and want to continue searching for the same results, simply press the  key again, and press enter (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 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  :

Now press. This will bring you to the end of the page:

End of the man page after SHIFT+g

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:

Specifying our search

Then hit enter to bring up the result:

Our search result

And the search is complete! Note that just as with , using   search with no pattern will use the last pattern to search.

Conclusion
This concludes the man guide. This will hopefully shed some light on navigating man pages, and maybe even give a few new tips to the more experienced users. For those who prefer alternate means of navigating man pages, the following are also available:


 * app-text/man2html - a program for converting man pages to html
 * app-text/tkman - a tk based man page browser

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

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Chris White