git-notes(1) Manual Page

List the notes object for a given object. If no object is given, show a list of all note objects and the objects they annotate (in the format "<note-object> <annotated-object>"). This is the default subcommand if no subcommand is given.

Add notes for a given object (defaults to HEAD). Abort if the object already has notes (use -f to overwrite existing notes). However, if you’re using add interactively (using an editor to supply the notes contents), then - instead of aborting - the existing notes will be opened in the editor (like the edit subcommand). If you specify multiple -m and -F, a blank line will be inserted between the messages. Use the --separator option to insert other delimiters. You can use -e to edit and fine-tune the message(s) supplied from -m and -F options interactively (using an editor) before adding the note.

最初のオブジェクトのノートを2番目のオブジェクト(デフォルトはHEAD)にコピーします。 2番目のオブジェクトにすでにノートがある場合、または最初のオブジェクトにノートがない場合は中止(abort)します(-f を使用して2番目のオブジェクトの既存のノートを上書きします)。このサブコマンドは git notes add [-f] -C $(git notes list <from-object>) <to-object> と同等です。

<from-object> SP <to-object> [ SP <rest> ] LF

Append new message(s) given by -m or -F options to an existing note, or add them as a new note if one does not exist, for the object (defaults to HEAD). When appending to an existing note, a blank line is added before each new message as an inter-paragraph separator. The separator can be customized with the --separator option. Edit the notes to be appended given by -m and -F options with -e interactively (using an editor) before appending the note.

指定のオブジェクトのノートを編集します(デフォルトはHEAD)。

指定のオブジェクトのノートを表示します(デフォルトはHEAD)。

指定のノートrefを現在のノートrefにマージします。 これにより、マージベース(存在する場合)以降に指定されたnote参照(「remote」と呼ばれる）によって行われた変更が現在のノートref(「local」と呼ばれる)にマージされます。

指定のオブジェクトのノートを削除します(デフォルトはHEAD)。 コマンドラインから0個または1個のオブジェクトを指定する場合、これは edit サブコマンドに空のノートメッセージを指定することと同じです。

存在しない(non-existing)/到達できない(unreachable) オブジェクトのすべてのノートを削除します。

現在のノートを出力します。これにより、現在のノートrefを(スクリプトなどから)簡単に取得する方法が提供されます。

すでにノートがあるオブジェクトにノートを追加する場合は、(中止するのではなく、)既存のノートを上書きします。

Use the given note message (instead of prompting). If multiple -m options are given, their values are concatenated as separate paragraphs. Lines starting with # and empty lines other than a single line between paragraphs will be stripped out. If you wish to keep them verbatim, use --no-stripspace.

Take the note message from the given file. Use - to read the note message from the standard input. Lines starting with # and empty lines other than a single line between paragraphs will be stripped out. If you wish to keep them verbatim, use --no-stripspace.

指定の BLOB オブジェクト(たとえば別のノート)をノート・メッセージとして受け取ります。 (オブジェクト間でノートをコピーするには、 これの代わりに git Notes copy <object> を使用してください。) デフォルトでは、 メッセージはそのままコピーされますが、 # で始まる行や段落間の2行以上の空行を削除したい場合、 --stripspace オプションとともに使用します。

-C と同様ですが、 -c を使用するとエディタが呼び出されるため、ユーザーはノートメッセージをさらに編集できます。

空のノートオブジェクトを保存できるようにします。 デフォルトの動作では、空のノートは自動的に削除されます。

カスタムの段落間区切りとして使用する文字列を指定します (必要に応じて末尾に改行(newline)が追加されます)。 --no-separator の場合、 段落間に区切りは追加されません。 これのデフォルトは1行の空行です。

Strip leading and trailing whitespace from the note message. Also strip out empty lines other than a single line between paragraphs. Lines starting with # will be stripped out in non-editor cases like -m, -F and -C, but not in editor case like git notes edit, -c, etc.

<ref>のノートツリーを操作します。 これは、 GIT_NOTES_REF と、 core.notesRef 構成をオーバーライドします。 refは、 refs/notes/ で始まる完全なref名を指定します。 notes/ で始まる場合、 refs/ が接頭辞として付けられ、それ以外の場合は refs/notes/ が接頭辞として付けられ、refのフルネームを形成します。

ノートが添付されていないオブジェクトからノートの削除を要求することをエラーと見なさないでください。

また、ノートを削除するために標準入力からオブジェクト名を読み取る(コマンドラインからオブジェクト名と組み合わせることができないわけではありません)。

何も削除しないでください。 ノートが削除されるオブジェクト名を報告するだけです。

ノートをマージするときは、指定の戦略を使用してノートの競合を解決します。 次の戦略が認識されます: manual(デフォルト)、 ours 、 theirs 、 union 、 cat_sort_uniq 。 このオプションは、 notes.mergeStrategy 構成設定をオーバーライドします。 各ノートマージ戦略の詳細については、以下の「NOTES MERGE STRATEGIES」セクションを参照してください。

進行中の git notes merge を完了させます。 .git/NOTES_MERGE_WORKTREE に保存されている git notes merge の競合を解決した場合は、このオプションを使用します。 これにより、 .git/NOTES_MERGE_WORKTREE にノートを追加することで、 git notes merge (.git/NOTES_MERGE_PARTIAL に保存)によって作成された部分的なマージコミットが修正されます。 .git/NOTES_MERGE_REF symref に保存されているノートrefは、結果のコミットに更新されます。

進行中の git notes merge を 中止(abort)/リセット します。つまり、ノートのマージは競合を伴います。これにより、ノートのマージに関連するすべてのファイルが削除されます。

ノートをマージするときは、黙って作業します。

ノートをマージするときは、よりおしゃべりになります。ノートを刈り込むときは、ノートが削除されたすべてのオブジェクト名を報告してください。

refs/notes/commits の代わりに読み取りおよび操作するノートref。省略されていないref名である必要があります。この設定は、環境およびコマンドラインから上書きできます。

ノートの競合を解決するときにデフォルトで選択するマージ戦略。 manual 、` ours`、 theirs、` union` 、cat_sort_uniq のいずれかである必要があります。 デフォルトは manual です。 各戦略の詳細については、 git-notes(1) の「NOTES MERGE STRATEGIES」セクションを参照してください。

refs/notes/<name> にノートをマージするときに、どのマージ戦略を選択するか。 これは、より一般的な notes.mergeStrategy をオーバーライドします。 利用可能な戦略の詳細については、 git-notes(1) の「NOTES MERGE STRATEGIES」セクションを参照してください。

git log 系のコマンドでコミット・メッセージを表示する際に、 core.notesRef や GIT_NOTES_REF で設定したデフォルトに加えて、どのref (グロブ、または複数回指定されている場合は複数ref)からノートを読み込むかを指定します。

<command> (現在は amend または rebase)でコミットを書き換え、 そして、 この変数が false に設定されている場合、git はノートを元のコミットから書き換えられたコミットにコピーしません。 デフォルトは true です。 下記 notes.rewriteRef も参照してください。

書き換え時にノートをコピーする場合(notes.rewrite.<command> オプション参照)、ターゲットコミットにすでにノートがある場合の対処方法を決定します。 overwrite 、 concatenate 、 cat_sort_uniq 、 ignore のいずれかである必要があります。 デフォルトは concatenate です。

書き換え中にノートをコピーする場合は、ノートをコピーする(完全修飾された)refを指定します。 グロブと見なしたら、マッチするすべてのrefのノートがコピーされます。 この構成を複数回指定することもできます。

refs/notes/commits の代わりに、どのrefからノートを操作するか。 これは core.notesRef 設定を上書きします。

コロンで区切られた ref または glob のリスト。コミットメッセージを表示する際に、デフォルトの core.notesRef または GIT_NOTES_REF に加えて、どの ref からノートを読み込むかを指定します。 これは notes.displayRef の設定よりも優先されます。

書き換え中にノートをコピーするときに、ターゲットコミットにすでにノートがある場合の対処方法。 overwrite 、concatenate 、 cat_sort_uniq 、ignore のいずれかである必要があります。 これは core.rewriteMode 設定を上書きします。

コミットを書き換える場合、元のコミットから書き換えられたコミットにコピーするためのノート。refまたはグロブ(glob)のコロンで区切られたリストである必要があります。