コマンド構文を表示するために使用されるシンボルの一般的な意味は何ですか？

Question

man 7 man-pages以下は、マニュアルページセクションの一般的な意味を説明する抜粋です。

   SYNOPSIS      A brief summary of the command or function's interface.

                 For commands, this shows the syntax of  the  command  and
                 its  arguments  (including options); boldface is used for
                 as-is text and italics are used to  indicate  replaceable
                 arguments.   Brackets  ([])  surround optional arguments,
                 vertical bars (|) separate choices,  and  ellipses  (...)
                 can  be  repeated.

ターミナルに「太字」と「イタリック体」が実際にどのように現れるかは別の質問だと付け加えたいです。私の端末では、太字は文字通りのテキストを意味し、下線付きのテキストは置換可能な引数を意味し、一部の端末ではそのような形式がまったく適用されない場合があります。

トーンは次のとおりです

選択項目は角かっこ内に表示されます。
個別に選択された垂直線
省略記号は、項目または要素を繰り返すことができることを示します。

全体として、これらの規則は実際に引用したマイクロソフトのドキュメントと非常によく似ています。

以下は、マニュアルページの概要例ですgit diff。

SYNOPSIS
       git diff [options] [<commit>] [--] [<path>...]
       git diff [options] --cached [<commit>] [--] [<path>...]
       git diff [options] <commit> <commit> [--] [<path>...]
       git diff [options] <blob> <blob>
       git diff [options] [--no-index] [--] <path> <path>

可能なオプションが多すぎるため、マニュアルページの作成者は要約にすべてのオプションをリストしません[options]。

概要に複数の行がある理由は、この特定のコマンドを使用する可能性がある（相互排他的）方法がいくつかあるためです。

角かっこ内のすべての内容はオプションであり、山かっこ内のすべての内容はプレースホルダーです。

（注：コミットとblobはGitに保存できるオブジェクトの種類です。blobはファイルの内容を表し、コミットはGitが追跡するファイルセット全体の状態を表します。質問には関係ありませんが、言及します。混乱を防ぐためです。）

別の例である command の概要は、grep別の規則を示しています。すべて大文字の単語は、時々プレースホルダを表示するために使用されます（上記のgitのマニュアルページにある山かっこなど）。

SYNOPSIS
       grep [OPTIONS] PATTERN [FILE...]
       grep [OPTIONS] -e PATTERN ... [FILE...]
       grep [OPTIONS] -f FILE ... [FILE...]

このコマンドを呼び出すには3つの方法がありますgrep。上記の内容を読むと、次のことがわかります。

grep apple orange pear

...これはappleパターンorangeであり、pearどちらもファイル名であることを意味します。

もう一度次からこれを確認できます。

grep -e apple -e orange pear grapefruit

...appleそしてorange両方ともパターンであり、両方ともpearファイルですgrapefruit。

それが何であるかについて方法コマンドの意味を見るとするモードとファイルが与えられたら、概要よりも多くのマニュアルページを読む必要があります。ただし、プロファイルを使用すると、指定したコマンドがさまざまなパラメータを解釈する方法を決定できます。

しかし、スキーム表記には絶対的な規則はありません。要約は次のとおりですsed。

SYNOPSIS
       sed [OPTION]... {script-only-if-no-other-script} [input-file]...

これを完全に理解するには、次の内容を見つけることができるマニュアルページをさらに読む必要があります。

   If no -e, --expression, -f, or --file option is given, then  the  first
   non-option  argument  is  taken  as  the  sed script to interpret.  All
   remaining arguments are names of input files; if  no  input  files  are
   specified, then the standard input is read.

Answer 1