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

[PATCH v2] doc: improve readability of --rebase-merges in git-rebase

From
Naveen Nathan <naveen@lastninja.net>
Date
Nov 11, 2019, 23:21 UTC
Message-ID
<20191111232137.GA29586@a.local>
In-Reply-To
<xmqqr22ehjbg.fsf@gitster-ct.c.googlers.com>

When --preserve-merges was deprecated in 427c3bd28a a sentence was introduced describing the difference between --rebase-merges and --preserve-merges which is a little unclear and difficult to parse. This patch improves readability while retaining original meaning.

Signed-off-by: Naveen Nathan <naveen@lastninja.net>
---
 Documentation/git-rebase.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-rebase.txt b/Documentation/git-rebase.txt
index 639a4179d1..0c4f038dd6 100644
--- a/Documentation/git-rebase.txt
+++ b/Documentation/git-rebase.txt
@@ -443,8 +443,8 @@ the `rebase-cousins` mode is turned on, such commits are instead rebased
 onto `<upstream>` (or `<onto>`, if specified).
 +
 The `--rebase-merges` mode is similar in spirit to the deprecated
-`--preserve-merges`, but in contrast to that option works well in interactive
-rebases: commits can be reordered, inserted and dropped at will.
+`--preserve-merges` but works with interactive rebases,
+where commits can be reordered, inserted and dropped at will.
 +
 It is currently only possible to recreate the merge commits using the
 `recursive` merge strategy; Different merge strategies can be used only via
-- 
2.21.0
Previous: Naveen NathanNext: Junio C Hamano
Message 5 of 6 in “doc: improve readability of --rebase-merges in git-rebase”
  1. doc: improve readability of --rebase-merges in git-rebaseNaveen Nathan, Nov 10, 2019
  2. Johannes SchindelinNov 11, 2019
  3. Junio C HamanoNov 11, 2019
  4. Naveen NathanNov 11, 2019
  5. doc: improve readability of --rebase-merges in git-rebaseNaveen Nathan, Nov 11, 2019
  6. Junio C HamanoNov 12, 2019

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.