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

[PATCHv3] Have git revert documentation reference new HOWTO on reverting faulty merges.

From
Boyd Stephen Smith Jr. <bss@iguanasuicide.net>
Date
Dec 22, 2008, 00:26 UTC
Message-ID
<200812211826.03208.bss@iguanasuicide.net>
In-Reply-To
<7vy6y9kxdh.fsf@gitster.siamese.dyndns.org>
Signed-off-by: Boyd Stephen Smith Jr <bss@iguanasuicide.net>
---
On Sunday 2008 December 21 15:54:18 Junio C Hamano wrote:
> Thanks.  I was thinking about doing this instead; how the reference to the
> HOW-TO is done is different, and I am hoping that it would give better
> result for HTML version at least.

Here's a pruned version of my prose, with your link style. I prefer my prose because I don't want to use the word "branch", which implies refs having some important in the later merges, which is not the case from what I understand.

 Documentation/git-revert.txt |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)
diff --git a/Documentation/git-revert.txt b/Documentation/git-revert.txt
index caa0729..ee9cb82 100644
--- a/Documentation/git-revert.txt
+++ b/Documentation/git-revert.txt
@@ -44,6 +44,14 @@ OPTIONS
 	option specifies the parent number (starting from 1) of
 	the mainline and allows revert to reverse the change
 	relative to the specified parent.
++
+Reverting a merge commit declares that you will never want the tree changes
+brought in by the merge.  As a result, later merges will only bring in tree
+changes introduced by commits that are not ancestors of the revert commit.
+This may or may not be what you want.
++
+See the link:howto/revert-a-faulty-merge.txt[revert-a-faulty-merge How-To] for
+more details.
 
 --no-edit::
 	With this option, 'git-revert' will not start the commit
-- 
1.6.0.2
-- 
Boyd Stephen Smith Jr.                     ,= ,-_-. =. 
bss@iguanasuicide.net                     ((_/)o o(\_))
ICQ: 514984 YM/AIM: DaTwinkDaddy           `-'(. .)`-' 
http://iguanasuicide.net/                      \_/     
Previous: Junio C Hamano
Message 7 of 7 in “Have manpage reference new documentation on reverting merges.”
  1. Have manpage reference new documentation on reverting merges.Boyd Stephen Smith Jr., Dec 21, 2008
  2. Junio C HamanoDec 21, 2008
  3. Boyd Stephen Smith Jr.Dec 21, 2008
  4. Junio C HamanoDec 21, 2008
  5. [PATCHv2] Have manpage reference new documentation on reverting merges.Boyd Stephen Smith Jr., Dec 21, 2008
  6. Junio C HamanoDec 21, 2008
  7. [PATCHv3] Have git revert documentation reference new HOWTO on reverting faulty merges.Boyd Stephen Smith Jr., Dec 22, 2008

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.