You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
2.4 KiB
81 lines
2.4 KiB
git-revert(1) |
|
============= |
|
|
|
NAME |
|
---- |
|
git-revert - Revert an existing commit |
|
|
|
SYNOPSIS |
|
-------- |
|
'git revert' [--edit | --no-edit] [-n] [-m parent-number] [-s] <commit> |
|
|
|
DESCRIPTION |
|
----------- |
|
Given one existing commit, revert the change the patch introduces, and record a |
|
new commit that records it. This requires your working tree to be clean (no |
|
modifications from the HEAD commit). |
|
|
|
Note: 'git revert' is used to record a new commit to reverse the |
|
effect of an earlier commit (often a faulty one). If you want to |
|
throw away all uncommitted changes in your working directory, you |
|
should see linkgit:git-reset[1], particularly the '--hard' option. If |
|
you want to extract specific files as they were in another commit, you |
|
should see linkgit:git-checkout[1], specifically the 'git checkout |
|
<commit> -- <filename>' syntax. Take care with these alternatives as |
|
both will discard uncommitted changes in your working directory. |
|
|
|
OPTIONS |
|
------- |
|
<commit>:: |
|
Commit to revert. |
|
For a more complete list of ways to spell commit names, see |
|
"SPECIFYING REVISIONS" section in linkgit:git-rev-parse[1]. |
|
|
|
-e:: |
|
--edit:: |
|
With this option, 'git-revert' will let you edit the commit |
|
message prior to committing the revert. This is the default if |
|
you run the command from a terminal. |
|
|
|
-m parent-number:: |
|
--mainline parent-number:: |
|
Usually you cannot revert a merge because you do not know which |
|
side of the merge should be considered the mainline. This |
|
option specifies the parent number (starting from 1) of |
|
the mainline and allows revert to reverse the change |
|
relative to the specified parent. |
|
|
|
--no-edit:: |
|
With this option, 'git-revert' will not start the commit |
|
message editor. |
|
|
|
-n:: |
|
--no-commit:: |
|
Usually the command automatically creates a commit with |
|
a commit log message stating which commit was |
|
reverted. This flag applies the change necessary |
|
to revert the named commit to your working tree |
|
and the index, but does not make the commit. In addition, |
|
when this option is used, your index does not have to match |
|
the HEAD commit. The revert is done against the |
|
beginning state of your index. |
|
+ |
|
This is useful when reverting more than one commits' |
|
effect to your index in a row. |
|
|
|
-s:: |
|
--signoff:: |
|
Add Signed-off-by line at the end of the commit message. |
|
|
|
|
|
Author |
|
------ |
|
Written by Junio C Hamano <gitster@pobox.com> |
|
|
|
Documentation |
|
-------------- |
|
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>. |
|
|
|
GIT |
|
--- |
|
Part of the linkgit:git[1] suite
|
|
|