SYNOPSIS
git revert [--[no-]edit] [-n] [-m <parent-number>] [-s] [-S[<keyid>]] <commit>… git revert (--continue | --skip | --abort | --quit)
DESCRIPTION
1つ以上の既存のコミットが与えられた場合、関連するパッチによって導入された変更を元に戻し、それらを記録するいくつかの新しいコミットを記録します。これには、作業ツリーがクリーンである必要があります(HEADコミットからの変更はありません)。
注意: git revert は、いくつかの新しいコミットを記録して、以前のコミットの効果を元に戻すために使用されます(多くの場合、障害のあるコミットのみ)。あなたが作業ディレクトリ内のコミットされていないすべての変更を破棄したい場合は、 git-reset(1) 、特に --hard オプションについて参照すべきです。あなたが別のコミットから特定のファイルを抽出したい場合は、 git-restore(1) 、特に --source オプションについて参照すべきです。これらは作業ディレクトリ内のコミットされていない変更を破棄するため、これらの選択肢には注意してください。
3つのコマンドの違いについては、 git(1) の「Reset, restore and revert」を参照してください。
OPTIONS
- <commit>…
-
元に戻すためのコミットを指定。コミット名を綴る方法のより完全なリストについては、 gitrevisions(7) を参照してください。コミットのセットを指定することもできますが、デフォルトではトラバーサルは実行されません。 git-rev-list(1) と、その
--no-walkオプションを参照してください。 -
-e -
--edit -
このオプションを使用すると、
git revertは「戻し」(the revert)をコミットする前にあなたにコミットメッセージを編集させます。これは、端末からコマンドを実行する場合のデフォルトです。 -
-m parent-number -
--mainline parent-number -
通常、マージのどの筋を本線(mainline)と見なすかわからないため、マージを元に戻すことはできません。 このオプションは、本線とする親番号(1から始まる)を指定し、指定された親を基準にして変更を元に戻すことができます。
マージコミットを戻す(revert)と、そのマージによってもたらされたツリーの変更が不要になることが宣言されます。その結果、その後に行われるマージでは、先に戻されたマージの先祖ではないコミットによってもたらされたツリーの変更のみが適用されます。これはあなたの望むところかもしれませんし、そうでないかもしれません。
詳細については、 revert-a-faulty-merge How-To (誤ったマージの取り消し方法)を参照してください。
-
--no-edit -
このオプションを使うと、 git revert はコミットメッセージエディタを起動しません。
-
--cleanup=<mode> -
このオプションは、コミットメッセージがコミット機構に渡される前にどのようにクリーンアップされるかを決定します。詳細については、git-commit(1) を参照してください。 特に、競合が発生した場合、 <mode> に値
scissorsが指定されていると、渡される前に、MERGE_MSG に切り取り線が追加されます。 -
-n -
--no-commit -
通常、コマンドは、どのコミットが元に戻されたかを示すコミットログメッセージを含むいくつかのコミットを自動的に作成します。このフラグは、名前付きコミットを作業ツリーとインデックスに戻すために必要な変更を適用(apply)しますが、コミットは行いません。さらに、このオプションを使用する場合、インデックスはHEADコミットと一致する必要はありません。 revertは、あなたのインデックスの開始状態に対して行われます。
これは、複数のコミットの効果を連続してインデックスにrevertする場合に役立ちます。
-
-S[<keyid>] -
--gpg-sign[=<keyid>] -
--no-gpg-sign -
GPG署名コミット。
keyid引数はオプションであり、デフォルトはコミッターIDになります。指定する場合は、スペースなしでオプションに指定する必要があります。--no-gpg-signは、commit.gpgSign構成変数と、 それより前で指定された--gpg-signの両方を打ち消すのに役立ちます。 -
-s -
--signoff -
コミットメッセージの最後に
Signed-off-byトレーラーを追加します。 詳細については、 git-commit(1) の signoff オプションを参照してください。 -
--strategy=<strategy> -
指定されたマージ戦略を使用します。指定できるのは一度だけです。詳細については、 git-merge(1) の「MERGE STRATEGIES」セクションを参照してください。
-
-X<option> -
--strategy-option=<option> -
マージ戦略固有のオプションをマージ戦略に渡します。詳細については、 git-merge(1) を参照してください。
-
--rerere-autoupdate -
--no-rerere-autoupdate -
rerere メカニズムが現在の競合で記録された解決を再利用して作業ツリー内のファイルを更新した後、解決の結果でインデックスも更新できるようにします。
--no-rerere-autoupdateは、別のgit addで結果をインデックスにコミットする前に、「rerere」が行ったことを再確認し、潜在的な間違いマージ(mismerges)を捉える良い方法です。 -
--reference -
ログ・メッセージの本文を "This reverts <full object name of the commit being reverted>." で始める代わりに、
--pretty=reference形式を使用してコミットを参照します(git-log(1) 参照)。revert.reference構成変数を使用して、このオプションをデフォルトで有効にすることができます。
SEQUENCER SUBCOMMANDS
-
--continue -
.git/sequencerの情報を使用して、進行中の操作の続行を行います。失敗したcherry-pickまたはrevertの競合を解決した後、続行するために使用できます。 -
--skip -
現在のコミットをスキップして、残りのシーケンスを続行します。
-
--quit -
進行中の今回の操作を忘れてください。チェリーピックまたはrevertに失敗した後、シーケンサーの状態をクリアするために使用できます。
-
--abort -
操作をキャンセルして、シーケンス操作前の状態に戻ります。
EXAMPLES
-
git revert HEAD~3 -
HEADの最後から4番目のコミットで指定された変更を元に戻し、元に戻した変更を使用して新しいコミットを作成します。
-
git revert -n master~5..master~2 -
コミットによって行われた変更を、masterの最後から5番目のコミット(それ自身を含む)から、masterの最後から3番目のコミット(それ自身を含む)に戻しますが、元に戻した変更でコミットを作成しないでください。元に戻すと、作業ツリーとインデックスのみが変更されます。
CONFIGURATION
このセクションの以下のすべては、 git-config(1) ドキュメントの抜粋です。 内容は git-config(1) ドキュメント にあるものと同一です:
- revert.reference
-
この変数を true に設定すると、
git revertは--referenceオプションが指定されているかのように振る舞います。
SEE ALSO
GIT
Part of the git(1) suite