aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2017-02-16 14:45:14 -0800
committerJunio C Hamano <gitster@pobox.com>2017-02-16 14:45:14 -0800
commitbf5f1191898c99502b0328eef25d589ce5ebfe28 (patch)
tree71d2a055e6428e1c37c8123a576a61f5de45e186
parente048a257bfe66e6eead5e212b5449ffd108de707 (diff)
parentae86372fcd1204c9acda8ea7f91d2995bdb39ab1 (diff)
downloadgit-bf5f1191898c99502b0328eef25d589ce5ebfe28.tar.gz
git-bf5f1191898c99502b0328eef25d589ce5ebfe28.tar.xz
Merge branch 'jk/reset-to-break-a-commit-doc'
Doc update. * jk/reset-to-break-a-commit-doc: Revert "reset: add an example of how to split a commit into two"
-rw-r--r--Documentation/git-reset.txt38
1 files changed, 0 insertions, 38 deletions
diff --git a/Documentation/git-reset.txt b/Documentation/git-reset.txt
index add6220fc..25432d925 100644
--- a/Documentation/git-reset.txt
+++ b/Documentation/git-reset.txt
@@ -292,44 +292,6 @@ $ git reset --keep start <3>
<3> But you can use "reset --keep" to remove the unwanted commit after
you switched to "branch2".
-Split a commit into two::
-+
-Suppose that you have created a commit, but later decide that you want to break
-apart the changes into two logical chunks and commit each separately. You want
-to include part of the original commit into the first commit, while including
-the remainder in a second commit. You can use git reset to rewind the history
-without changing the index, and then use git add -p to interactively select
-which hunks to put into the first commit.
-+
-------------
-$ git reset HEAD^ <1>
-$ git add -p <2>
-$ git diff --cached <3>
-$ git commit -c HEAD@{1} <4>
-...
-$ git add ... <5>
-$ git diff --cached <6>
-$ git commit ... <7>
-------------
-+
-<1> First, reset the history back one commit so that we remove the original
- commit, but leave the working tree with all the changes.
-<2> Now, interactively select hunks to add to a new commit using git add -p.
- This will ask for each hunk separately and you can use simple commands like
- "yes, include", "no don't include" or even "edit".
-<3> Once satisfied with the hunks, you should verify that it is what you
- expected by using git diff --cached to show all changes in the index.
-<4> Next, commit the changes stored in the index. "-c" specifies to load the
- editor with a commit message from a previous commit so that you can re-use the
- original commit message. HEAD@{1} is special notation to reference what
- HEAD used to be prior to the reset command. See linkgit:git-reflog[1] for
- more details.
-<5> Now you've created the first commit, and can repeat steps 2-4 as often as
- you like to break the work into any number of commits. Here we show a second
- step which simply adds the remaining changes.
-<6> Then check again that the changes are what you expected to add.
-<7> And finally commit the remaining changes.
-
DISCUSSION
----------