git-add(1) Manual Page

コンテンツを追加するファイル。 ファイルグロブ(例: *.c)を指定して、マッチするすべてのファイルを追加できます。 また、先頭のディレクトリ名(たとえば dir で dir/file1 と dir/file2 を追加)を指定して、ディレクトリ全体の現在の状態に一致するようにインデックスを更新することもできます(たとえば、 dir を指定すると、作業ツリーで変更されたファイル dir/file1 の変更記録や、作業ツリーに追加されたファイル dir/file2 の追加記録だけでなく、作業ツリーから削除されたファイル dir/file3 の削除記録も行われます)。 古いバージョンのGitでは、削除されたファイルを無視していたことに注意してください。 変更されたファイルまたは新しいファイルを追加し、削除されたファイルを無視する場合は、 --no-all オプションを使用します。

実際にファイルを追加するのではなく、ファイルが存在するかどうか、および/または 無視されるかどうかを表示します。

おしゃべりにします。

これ以外の場合は無視されるファイルの追加を許可します。

スパース・チェックアウト・コーン(sparse-checkout cone)の外側のインデックス・エントリを更新できるようにします。 通常、 git add はパスがスパース・チェックアウト・コーン内に収まらないインデックス・エントリの更新を拒否します。これらのファイルは警告なしに作業ツリーから削除される可能性があるためです。 詳細については、 git-sparse-checkout(1) を参照してください。

作業ツリーの変更されたコンテンツを対話的にインデックスに追加します。 オプションのパス引数を指定して、操作を作業ツリーのサブセットに制限することができます。 詳細については、「Interactive mode」を参照してください。

インデックスと作業ツリーの間でパッチの塊(hunk)を対話的に選択し、それらをインデックスに追加します。 これにより、ユーザーは、変更されたコンテンツをインデックスに追加する前に、違いを確認することができます。

コンテキストの「<n>行」の diff を生成します。 デフォルトは diff.context 、 または構成オプションが設定されていない場合は 3 です。

指定の「<number>行」までの diff ハンク間のコンテキストを表示し、 それによって互いに近いハンクを融合します。 デフォルトは diff.interHunkContext 、 または構成オプションが設定されていない場合は 0 です。

差分とインデックスをエディタで開き、ユーザに編集させる。 エディタを閉じた後、ハンクヘッダ(hunk headers)を調整し、インデックスにパッチを適用する。

<pathspec>にマッチするエントリがすでにある場所でインデックスを更新します。 これにより、作業ツリーにマッチするようにインデックスエントリが削除および変更されますが、新しいファイルは追加されません。

作業ツリーに <pathspec> にマッチするファイルがある場合だけでなく、 インデックスにすでにエントリがある場合にも、 インデックスを更新します。 これにより、作業ツリーにマッチするようにインデックス・エントリが 追加や変更や削除 されます。

インデックスに未知の新しいファイルや、作業ツリーで変更されたファイルを追加してインデックスを更新するが、しかし、作業ツリーから削除されたファイルは無視する。 <pathspec> が使用されてい無い場合、このオプションは何もしません。

パスが後で追加されるという事実のみを記録します。 パスのエントリは、コンテンツなしでインデックスに配置されます。 これは、特に、そのようなファイルのステージングされていないコンテンツを git diff で表示し、それらを git commit -a でコミットする場合に役立ちます。

ファイルを追加しません。 ただし、インデックス内の stat() 情報のみ更新します。

一部のファイルのインデックス作成エラーが原因で追加できなかった場合は、操作を中止せずに、他のファイルの追加を続行します。 コマンドは、ゼロ以外のステータスで終了します。 構成変数 add.ignoreErrors をtrueに設定して、これをデフォルトの動作にすることができます。

このオプションは、 --dry-run と一緒にのみ使用できます。 このオプションを使用することにより、ユーザーは、指定されたファイルがすでに作業ツリーに存在するかどうかに関係なく、それらのファイルのどれが無視されるかどうかを確認できます。

デフォルトでは、 git submodule add を使用して .gitmodules にエントリを作成せずに、 埋め込みリポジトリー(embedded repository)をインデックスに追加すると、 git add が警告を表示します。 このオプションは、警告を抑制します(たとえば、サブモジュールで手動で操作を実行している場合)。

全ての追跡されたファイル(tracked files)に「クリーン」プロセスを新たに適用して、それらをインデックスに強制的に再度追加します。 これは、誤った CRLF/LF 行末で追加されたファイルを修正するために、 core.autocrlf 構成または text 属性を変更した後に役立ちます。 このオプションは -u の機能を含んでいます。 単独の CR 文字は変更されないため、CRLF は LF にクリーンアップされますが、 CRCRLF シーケンスは部分的にクリーンアップされ CRLF になります。

追加されたファイルの実行可能ビットを上書きします。 実行可能ビットはインデックス内でのみ変更され、ディスク上のファイルは変更されません。

パススペック(pathspec)は、コマンドライン引数の代わりに <file> で渡されます。 <file> が正確に "-" の場合、標準入力が使用されます。 パススペック要素は、LFまたは CR/LF で区切られます。 パススペック要素は、構成変数 core.quotePath で説明されているようにクォートできます(git-config(1) 参照)。 --pathspec-file-nul および グローバルの --literal-pathspecs も参照してください。

--pathspec-from-file でのみ意味があります。 pathspec 要素は NUL 文字で区切られ、他のすべての文字は文字通りに解釈されます(改行と引用符を含む)。

このオプションは、コマンドラインオプションをファイルのリストから分離するために使用できます(ファイル名がコマンドラインオプションと間違えられる可能性がある場合に便利です)。

これは、HEAD とインデックスの間の変更(つまり、 git commit とした場合にコミットされるもの)、および、各パスのインデックスと作業ツリーファイルの間の変更(つまり、 git add を使用して、 git commit する前にさらにステージングできるもの)を示しています。 出力例は以下のようになります:

              staged     unstaged path
     1:       binary      nothing foo.png
     2:     +403/-35        +1/-1 add-interactive.c

これにより、ステータス情報が表示され、 Update>> プロンプトが表示されます。 プロンプトが二重の >> で終わる場合は、空白またはコンマで連結して複数の選択を行うことができます。 また、範囲指定もできます。 例えば、 2-5 7,9 でリストから 2,3,4,5,7,9 を選択します。 範囲内の2番目の数字を省略すると、残りのすべてが適用されます。 例えば、 7- はリストから 7,8,9 を選択します。 * で全選択できます。

           staged     unstaged path
  1:       binary      nothing foo.png
* 2:     +403/-35        +1/-1 add-interactive.c

Update>> -2

これは「update」と非常によく似たUIを持ち、選択されたパスのステージングされた情報はHEADバージョンの情報に戻されます(revert)。 新しいパス達を revert すると、追跡されなくなります。

これは、「update」および「revert」と非常によく似たUIを備えており、追跡されていないパスをインデックスに追加できます。

これにより、選択に似た status から1つのパスを選択できます。 パスを選択すると、インデックスと作業ツリーファイルの差分が表示され、各ハンクの変更をステージングするかどうかを尋ねられます。 以下のオプションのいずれかを選択してからreturnキーをタイプできます。

y - stage this hunk(このハンクをステージする)
n - do not stage this hunk(このハンクをステージしない)
q - quit; do not stage this hunk or any of the remaining ones(終了;このハンクと残りをステージしない)
a - stage this hunk and all later hunks in the file(ファイル内の、 このハンクとそれ以降の全てのハンクをステージする)
d - do not stage this hunk or any of the later hunks in the file(ファイル内の、 このハンクとそれ以降の全てのハンクをステージしない)
g - select a hunk to go to(指定のハンク番号のハンクにジャンプ)
/ - search for a hunk matching the given regex(指定の正規表現にマッチするハンクを検索)
j - go to the next undecided hunk, roll over at the bottom(次の未決定ハンクに移動し、 最後まで行ったら先頭に戻る)
J - go to the next hunk, roll over at the bottom(次のハンクへ移動し、最後まで行ったら先頭に戻る)
k - go to the previous undecided hunk, roll over at the top(前の未決定ハンクに移動する。最初まで行ったら最後へ戻る)
K - go to the previous hunk, roll over at the top(前のハンクに移動する。最初まで行ったら最後へ戻る)
s - split the current hunk into smaller hunks(現在のハンクをより小さなハンクに分割)
e - manually edit the current hunk(現在のハンクを手動で編集)
p - print the current hunk(現在のハンクを表示)
P - print the current hunk using the pager(ページャーで現在のハンクを表示)
? - print help(このヘルプを表示)

これにより、コミットされる内容(つまり、 HEAD 〜インデックス間)を確認できます。

インデックス作成エラーにより一部のファイルを追加できない場合に、 ファイルの追加を続行するように git add に指示します。 --ignore-errors オプションと同等です。 add.ignore-errors は、 構成変数の通常の命名規則に従っていないため、 非推奨になりました。