Как читать справочные страницы Linux?

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

Я понимаю, что справочная страница разделена на части: NAME, SYNOPSIS, DESCRIPTION, OPTIONS, EXPRESSIONS, EXAMPLES и т. д. Но я понятия не имею, что означают все параметры, например, сколько параметров должен иметь каждый параметр, их зависимости и т. д.

Может кто-нибудь, пожалуйста, проясните это для меня?

Есть ли документы на это?


person cizixs    schedule 12.03.2014    source источник
comment
Возможно, вам поможет чтение man man.   -  person devnull    schedule 12.03.2014
comment
Stack Overflow — это сайт для вопросов по программированию и разработке. Этот вопрос кажется не по теме, потому что он не о программировании или разработке. См. раздел О каких темах я могу задать здесь в Справочном центре. Возможно, Суперпользователь или Unix & Linux Stack Exchange лучше спросить.   -  person jww    schedule 19.08.2018
comment
unix.stackexchange.com/q/193815/34720   -  person    schedule 08.04.2019
comment
и проголосовали за хорошую меру.   -  person tink    schedule 25.06.2019


Ответы (4)


Все справочные страницы имеют общий макет, оптимизированный для представления на простом текстовом дисплее ASCII, возможно, без какой-либо подсветки или управления шрифтом. Присутствующие разделы могут включать:

NAME

Имя команды или функции, за которым следует однострочное описание того, что она делает.

SYNOPSIS

В случае команды — формальное описание того, как ее запустить и какие параметры командной строки она принимает. Для программных функций список параметров, которые принимает функция, и заголовочный файл, содержащий ее определение.

DESCRIPTION

Текстовое описание работы команды или функции.

EXAMPLES

Некоторые примеры общего использования.

SEE ALSO

Список связанных команд или функций. Могут присутствовать и другие разделы, но они недостаточно стандартизированы для справочных страниц. Общие примеры включают: OPTIONS, EXIT STATUS, ENVIRONMENT, BUGS, FILES, AUTHOR, REPORTING BUGS, HISTORY и COPYRIGHT.

См. также Википедию на справочной странице.

person Laxmikant Ratnaparkhi    schedule 12.03.2014

Быть продуктивным в чтении справочных страниц

Помимо ответа ЛакшмиКанта, я хотел бы добавить еще кое-что, что на самом деле сделает вас быстрее и продуктивнее при чтении справочных страниц.

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

Несколько типичных примеров:

  • Нажмите /, а затем введите ключевое слово, которое вы хотите найти, а затем нажмите клавишу ввода. Он выделит первый результат. Затем вы можете перейти к следующему результату поиска, нажав n, и вернуться назад, нажав Shift+n.

  • Если вы читаете очень длинную страницу и вам нужно переключаться между несколькими разделами, используйте маркеры. Скажем, я нахожусь в определенной позиции страницы руководства. Чтобы отметить позицию, я нажимаю m, а затем какую-нибудь клавишу, скажем, 1. Теперь позиция сохраняется на отметке 1. Если я прокручиваю что-то еще и мне нужно вернуться к этой позиции, я просто нажимаю a, а затем 1.

  • Используйте d и u для прокрутки на полстраницы вниз/вверх.

И помните, чтобы выйти из любой команды/режима, упомянутых выше, ключ, конечно же, esc.

ОБНОВЛЕНИЕ: использование VIM для чтения справочных страниц

Чтобы быть еще более продуктивным, вы можете напрямую использовать vim, например:

man ls | vi -

Или, что еще лучше, определите функцию в файле ~/.bashrc (если вы используете bash):

vman() { vim <(man $1); }

ИСТОЧНИК: https://stackoverflow.com/a/25057995/1359467

person shivams    schedule 26.01.2015
comment
Хороший совет. Было бы неплохо добавить b, чтобы перейти на back (вверх) страницу, и 1G, чтобы вернуться наверх. Кроме того, если вы не знаете фактического названия нужной вам команды, но, скажем, знаете, что она связана с USB, вы можете выполнить man -k USB, чтобы получить список подходящих страниц. - person Mark Setchell; 26.01.2015
comment
Спасибо, что добавили это :) - person shivams; 26.01.2015
comment
Также есть разные сочетания клавиш для человека. В то время как в Debian для прокрутки на одну строку вниз/вверх нужно нажимать как в vim j/k, в Ubuntu клавиши как в Emacs C-n/C-p. Вы можете добавить, как настроить vim-подобные клавиши в man, так как их легче нажимать. - person Hi-Angel; 12.02.2015
comment
Очень полезно. Я полагаю, что разница исходит от разных пейджеров и, следовательно, не является частью человека. Использование vim for man делает его намного более продуктивным+. - person Boyang; 27.01.2016

Если вы хотите прочитать справочные страницы, возможно, статьи из The Linux Journal на Получение справки по Linux — часть 1: справочные страницы и Получение справки по Linux — Часть 2: информация поможет вам. Также у нас есть info страницы в Linux, и они более подробные, чем man страницы... Вы можете прочитать вывод следующих команд:

  • info man
  • info info
  • man info
  • man man

Вам также пригодятся следующие ссылки: 1 2 3 4

person MLSC    schedule 12.03.2014

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

person nikhil mehta    schedule 12.03.2014