Как правильно прочитать документацию (синопсис) bash команд?

Как правильно прочитать документацию (синопсис) bash команд?

27.08.2017 05:14:49 Просмотров 28 Источник

Здравствуйте, решил поизучать команды bash и сразу столкнулся с проблемой документации. Например, хочу прочитать про команду git, пишу в консоли man git и вижу следующее:

консоль

Как правильно прочитать шаблон в секции SYNOPSIS, ну то есть что означают [], <> и т.д.? Я поверхностно понимаю, что они означают, но где можно подробно прочитать об этом (желательно из официальных источников)?

У вопроса есть решение - Посмотреть?

https://ru.stackoverflow.com/questions/711181/%d0%9a%d0%b0%d0%ba-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d1%8c%d0%bd%d0%be-%d0%bf%d1%80%d0%be%d1%87%d0%b8%d1%82%d0%b0%d1%82%d1%8c-%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b0%d1%86%d0%b8%d1%8e-%d1%81%d0%b8%d0%bd%d0%be%d0%bf%d1%81%d0%b8%d1%81-bash-%d0%ba%d0%be%d0%bc%d0%b0%d0%bd%d0%b4#comment1063766_711181
Поправлю коллегу: без [] обязательный параметр; между <> подстановка одного из многих, например. push, pull и т.д.

Ответы - Как правильно прочитать документацию (синопсис) bash команд? / Как правильно прочитать документацию (синопсис) bash команд?

Является ответом!
bukkojot

27.08.2017 05:26:30

man man

.

   Conventional  section  names  include  NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS,
   CONFORMING TO, NOTES, BUGS, EXAMPLE, AUTHORS, and SEE ALSO.

   The following conventions apply to the SYNOPSIS section and can be used as a guide in other sections.

   bold text          type exactly as shown.
   italic text        replace with appropriate argument.
   [-abc]             any or all arguments within [ ] are optional.
   -a|-b              options delimited by | cannot be used together.
   argument ...       argument is repeatable.
   [expression] ...   entire expression within [ ] is repeatable.

   Exact rendering may vary depending on the output device.  For instance, man will usually not be able to render italics when running in a terminal, and  will
   typically use underlined or coloured text instead.
https://ru.stackoverflow.com/questions/711181/%d0%9a%d0%b0%d0%ba-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d1%8c%d0%bd%d0%be-%d0%bf%d1%80%d0%be%d1%87%d0%b8%d1%82%d0%b0%d1%82%d1%8c-%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b0%d1%86%d0%b8%d1%8e-%d1%81%d0%b8%d0%bd%d0%be%d0%bf%d1%81%d0%b8%d1%81-bash-%d0%ba%d0%be%d0%bc%d0%b0%d0%bd%d0%b4/711190#comment1063685_711190
такую команду я тоже запускал, но у меня не высвечивается, то что Вы указали в ответе, у меня макос, запускаю консоль через прогу terminal или iTerm
https://ru.stackoverflow.com/questions/711181/%d0%9a%d0%b0%d0%ba-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d1%8c%d0%bd%d0%be-%d0%bf%d1%80%d0%be%d1%87%d0%b8%d1%82%d0%b0%d1%82%d1%8c-%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b0%d1%86%d0%b8%d1%8e-%d1%81%d0%b8%d0%bd%d0%be%d0%bf%d1%81%d0%b8%d1%81-bash-%d0%ba%d0%be%d0%bc%d0%b0%d0%bd%d0%b4/711190#comment1063740_711190
@mars Судя по всему, пользователям macOS за синтаксисом надо идти в man 5 manpages, в секцию MANUAL PAGE SYNTAX.
https://ru.stackoverflow.com/questions/711181/%d0%9a%d0%b0%d0%ba-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d1%8c%d0%bd%d0%be-%d0%bf%d1%80%d0%be%d1%87%d0%b8%d1%82%d0%b0%d1%82%d1%8c-%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b0%d1%86%d0%b8%d1%8e-%d1%81%d0%b8%d0%bd%d0%be%d0%bf%d1%81%d0%b8%d1%81-bash-%d0%ba%d0%be%d0%bc%d0%b0%d0%bd%d0%b4/711190#comment1070118_711190
@Ainar-G Такой команды у меня не существует. Побродив по форуму Apple, выяснилось, что этой команды (файла) больше нету в новых версиях macOs. Но спасибо за ссылку на ее веб версию! Хотя бы там можно почитать
https://ru.stackoverflow.com/questions/711181/%d0%9a%d0%b0%d0%ba-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d1%8c%d0%bd%d0%be-%d0%bf%d1%80%d0%be%d1%87%d0%b8%d1%82%d0%b0%d1%82%d1%8c-%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b0%d1%86%d0%b8%d1%8e-%d1%81%d0%b8%d0%bd%d0%be%d0%bf%d1%81%d0%b8%d1%81-bash-%d0%ba%d0%be%d0%bc%d0%b0%d0%bd%d0%b4/711190#comment1070239_711190
Они убрали man? Тогда какое отношение имеет макось к unix и shell?
Закрыть X