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

Re: git pull (Re: need advice on usage patterns)

From
Thomas Rast <trast@student.ethz.ch>
Date
Jul 27, 2010, 09:13 UTC
Message-ID
<201007271113.32711.trast@student.ethz.ch>
In-Reply-To
<20100726200613.GB1451@burratino>
Jonathan Nieder wrote:
Show 24 quoted lines
> Thomas Rast wrote:
> [...]
> >                       Or worse, verify that their git-reset has
> > --merge by a quick test (1b5b465 is in 1.6.2) but then find that it
> > does not help with backing out of a merge (e11d7b5 is only in 1.7.0!).
> > 
> > Then again, who reads these manpages anyway?  And we shouldn't let old
> > versions get in the way of having consistent and up-to-date docs.  So,
> 
> Agh, surely we can do better.  Maybe:
> 
> 	See linkgit:git-merge[1] for details, including how conflicts
> 	are presented and handled.
> 
> 	ifdef::stalenotes[]
> 	In git 1.7.0 or later, to cancel a conflicting merge, use
> 	`git reset --merge`.
> 	*Warning*: In older versions of git, running 'git pull'
> 	with uncommited changes is discouraged: while possible,
> 	it leaves you in a state that may be hard to back out of
> 	in the case of a conflict.
> 	else::stalenotes[]
> 	To cancel a conflicting merge, use `git reset --merge`.
> 	endif::stalenotes[]

Sounds good. Maybe you can call this attribute 'webdocs' or so, so that we have a generic means of modifying the kernel.org hosted docs?

Also, apparently there is no else::...[] so you have to do an endif/ifndef pair.

-- 
Thomas Rast
trast@{inf,student}.ethz.ch
Previous: Jonathan NiederNext: Ævar Arnfjörð Bjarmason
Message 5 of 8 in “need advice on usage patterns”
  1. Geoff RussellJul 26, 2010
  2. git pull (Re: need advice on usage patterns)Jonathan Nieder, Jul 26, 2010
  3. Thomas RastJul 26, 2010
  4. Jonathan NiederJul 26, 2010
  5. Thomas RastJul 27, 2010
  6. Ævar Arnfjörð BjarmasonJul 26, 2010
  7. Geoff RussellJul 26, 2010
  8. Jonathan NiederJul 26, 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.