git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 2/7] Documentation: suggest `reset --merge` in How Merge Works section

From
Jonathan Nieder <jrnieder@gmail.com>
Date
Jan 23, 2010, 09:31 UTC
Message-ID
<20100123093118.GC7571@progeny.tock>
In-Reply-To
<20100123092551.GA7571@progeny.tock>

The 'merge' manual suggests 'reset' to cancel a merge at the end of the Merge Strategies list. It is more logical to explain this right before explaining how merge conflicts work, so the daunted reader can have a way out when he or she needs it most.

While at it, make the advice more dependable and self-contained by providing the --merge option.

Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
---
This should make the reference to 'git reset' easier to find on
second reading.  Something like this ought to happen if we are
going to move the Merge Strategies list down towards the end of
the man page.
 Documentation/git-merge.txt |    6 +++---
 1 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt
index 6aa2bf3..1fecedb 100644
--- a/Documentation/git-merge.txt
+++ b/Documentation/git-merge.txt
@@ -45,9 +45,6 @@ include::merge-options.txt[]
 include::merge-strategies.txt[]
 
 
-If you tried a merge which resulted in complex conflicts and
-want to start over, you can recover with 'git reset'.
-
 HOW MERGE WORKS
 ---------------
 
@@ -115,6 +112,9 @@ When there are conflicts, the following happens:
    same and the index entries for them stay as they were,
    i.e. matching `HEAD`.
 
+If you tried a merge which resulted in complex conflicts and
+want to start over, you can recover with `git reset --merge`.
+
 HOW CONFLICTS ARE PRESENTED
 ---------------------------
 
-- 
1.6.6
Previous: Jonathan NiederNext: Jonathan Nieder
Message 3 of 11 in “clarify 'git merge' documentation”
  1. 0/7 clarify 'git merge' documentationJonathan Nieder, Jan 23, 2010
  2. 1/7 Documentation: merge: move configuration section to endJonathan Nieder, Jan 23, 2010
  3. 2/7 Documentation: suggest `reset --merge` in How Merge Works sectionJonathan Nieder, Jan 23, 2010
  4. 3/7 Documentation: merge: move merge strategy list to endJonathan Nieder, Jan 23, 2010
  5. 4/7 Documentation: merge: add an overviewJonathan Nieder, Jan 23, 2010
  6. Raja R HarinathFeb 12, 2010
  7. 5/7 Documentation: emphasize when git merge terminates earlyJonathan Nieder, Jan 23, 2010
  8. 6/7 Documentation: merge: add a section about fast-forwardJonathan Nieder, Jan 23, 2010
  9. 7/7 Documentation: simplify How Merge WorksJonathan Nieder, Jan 23, 2010
  10. Thomas RastJan 24, 2010
  11. Junio C HamanoJan 24, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.