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

Re: [PATCH] doc/rebase: extend examples to show continuing branches

From
Junio C Hamano <gitster@pobox.com>
Date
Mar 5, 2019, 14:03 UTC
Message-ID
<xmqqr2blto3k.fsf@gitster-ct.c.googlers.com>
In-Reply-To
<alpine.LFD.2.21.1903050545460.24324@localhost.localdomain>
"Robert P. J. Day" <rpjday@crashcourse.ca> writes:
Show 5 quoted lines
> Currently, all of the examples for "man git-rebase" show rebasing from
> a branch that has had no further development, which might mislead
> readers into thinking that that is a necessary condition for rebasing,
> so tweak the examples to show further development on such a branch to
> clarify that.

We state the status-quo in present tense to start problem description, so "Currently" is a noise word you can and should omit.

As I already said, at least one example that rebases a branch that was forked from the midpoint of another branch, so the problem description is already false. If we apply this patch, do we lose all examples that rebase a branch that purely builds on top of the tip of another branch? That would also mislead readers into thinking that you need to advance the base branch before you can rebase the forked branch ;-).

Previous: Robert P. J. DayNext: Robert P. J. Day
Message 2 of 3 in “doc/rebase: extend examples to show continuing branches”
  1. doc/rebase: extend examples to show continuing branchesRobert P. J. Day, Mar 5, 2019
  2. Junio C HamanoMar 5, 2019
  3. Robert P. J. DayMar 5, 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.