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

[PATCH 2/3] docs: say that `--rebase=preserve` is deprecated

From
Johannes Schindelin via GitGitGadget <gitgitgadget@gmail.com>
Date
May 28, 2019, 12:42 UTC
Message-ID
<09cdff86fb42ee0dbc6ce6a1e276a17811a72021.1559047333.git.gitgitgadget@gmail.com>
In-Reply-To
<pull.227.git.gitgitgadget@gmail.com>
From: Johannes Schindelin <johannes.schindelin@gmx.de>

As of Git v2.22.0, the `--preserve-merges` backend of `git rebase` will be officially deprecated in favor of the `--rebase-merges` backend. Consequently, `git pull --rebase=preserve` will also be deprected. State this explicitly.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
 Documentation/git-pull.txt | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-pull.txt b/Documentation/git-pull.txt
index 118d9d86f7..a5e9501a0a 100644
--- a/Documentation/git-pull.txt
+++ b/Documentation/git-pull.txt
@@ -112,8 +112,9 @@ When set to `merges`, rebase using `git rebase --rebase-merges` so that
 the local merge commits are included in the rebase (see
 linkgit:git-rebase[1] for details).
 +
-When set to preserve, rebase with the `--preserve-merges` option passed
-to `git rebase` so that locally created merge commits will not be flattened.
+When set to `preserve` (deprecated in favor of `merges`), rebase with the
+`--preserve-merges` option passed to `git rebase` so that locally created
+merge commits will not be flattened.
 +
 When false, merge the current branch into the upstream branch.
 +
-- 
gitgitgadget
Previous: Johannes Schindelin via GitGitGadgetNext: Johannes Schindelin via GitGitGadget
Message 3 of 4 in “Deprecate git rebase -p even more”
  1. 0/3 Deprecate git rebase -p even moreJohannes Schindelin via GitGitGadget, May 28, 2019
  2. 1/3 tests: mark a couple more test cases as requiring `rebase -p`Johannes Schindelin via GitGitGadget, May 28, 2019
  3. 2/3 docs: say that `--rebase=preserve` is deprecatedJohannes Schindelin via GitGitGadget, May 28, 2019
  4. 3/3 rebase docs: recommend `-r` over `-p`Johannes Schindelin via GitGitGadget, May 28, 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.