Интерактивная ссылка использования команды: у Вас обычно есть это на Unix?

Обратите внимание, что man-страницы GNU coreutils сгенерированы из $cmd --help

Также обратите внимание, что bash builtins, по крайней мере, не поддерживает --help. Там вам нужно использовать, например, маску help umask. Теперь POSIX разрешает, и ksh, по крайней мере, использует umask --help. Недавно было предложено, чтобы bash также мог принять этот синтаксис

В вашем примере вы ссылаетесь на инструменты GNU. Они доступны для Linux и многих других платформ и несколько необычны с точки зрения документации.

Инструменты GNU, на самом деле , похоже, имеют три уровня все более подробной интерактивной справки:

- справка как общий параметр команды - краткое использование summary ,
man - классические справочные страницы, «краткий справочник» и
info - более подробное, специфичное для GNU руководство - полная, официальная документация .

Часто человек просто использует справочную страницу как стандартную документацию - даже зная, что «они говорят», что информационная документация GNU является более подробной и официальной.

Это будет немного отличаться в зависимости от предпочтений, но я думаю, что следующий шаблон использования довольно распространен:

• с использованием man foo по по умолчанию ,
  • с объяснением всех параметров
  • иногда кажется немного кратким, но достаточно хорошим
• используйте foo --help иногда, для небольших вопросов, как неуверенность об имени опции,
  
  • с кратким описанием в компактном формате
• и используйте info foo ... почти never .
  • , который, вероятно, предоставит некоторые дополнительные детали контекста и ссылки на другие команды
  • , но никто не может использовать пользовательский интерфейс информационного браузера в стиле emacs, поэтому мы не узнаем точно.
• и прочая сетевая документация,
  • как будто страница руководства была слишком краткой.

Однако есть одна загвоздка:

Для наиболее часто используемых команд из пакета coreutils , например ls , cp ], mkdir , csplit и многие другие,

страница руководства man foo содержит ту же информацию, что и foo --help . ⁽¹⁾

Это означает «настоящую документацию» , фактически, не на страницах руководства - как мы думали ...
Фактически он находится в файлах GNU info , которые мы не читали !

Теперь, глядя на страницу man и (нижнюю часть) - help , трудно заметить, что содержание одинаковое, потому что страница руководства выглядит так "более подробный". Это потому, что разница в плотности расположения текста между двумя вариантами очень велика. Чрезвычайно сжатый в - help , по сравнению с чрезвычайно расслабленным интервалом в man .

Сравните сами, впечатляет:

ls --help | меньше

чел. меньше

info --subnodes ls | less

(Параметр - подузлы отображает страницу линейно для сравнения. Сама по себе info показывает гипертекст, связанный между документами, подобными HTML. man команда включает less для принудительного вывода неокрашенного цвета для упрощения сравнения.)

Существуют более удобные альтернативы стандартной программе просмотра информации info , например - для терминала - pinfo или - для графического интерфейса - konqueror . Пример использования такой:
pinfo ls или konqueror info: ls или использование info: ls в строке URL konqueror .

В качестве особого случая ,документация внутренних команд GNU bash ,
которые называются встроенными командами оболочки , доступны с помощью команды help .
Например, в командной строке bash попробуйте
help cd

_{1) К счастью, @ PádraigBrady указал на это в своем ответе}