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

Re: [PATCH] git-rev-list.txt: prune options in synopsis

From
Jeff King <peff@peff.net>
Date
Oct 11, 2019, 16:11 UTC
Message-ID
<20191011161112.GA19741@sigill.intra.peff.net>
In-Reply-To
<c9e7fbd6-7ad6-bce9-1e17-6391ab3e0630@iee.email>
On Fri, Oct 11, 2019 at 05:02:33PM +0100, Philip Oakley wrote:
Show 6 quoted lines
> Another case, of a different style, is that of `git bundle --all` which does
> need mentioning that particular rev-list option as a major usage (I couldn't
> manage to understand the three layers of man page that needed reading).
> 
> I had proposed a patch many years ago [1] but the feedback wasn't positive,
> though my SO question continues [2] to get votes.

Yeah, I agree that "git bundle" could be more clear about this. I think just adding an example like this might help:

  # generate a bundle similar to what "git clone" would produce
  git bundle create file.bundle --branches --tags
-Peff
Previous: Philip Oakley
Message 5 of 5 in “git-rev-list.txt: prune options in synopsis”
  1. git-rev-list.txt: prune options in synopsisDenton Liu, Oct 5, 2019
  2. Junio C HamanoOct 5, 2019
  3. Jeff KingOct 11, 2019
  4. Philip OakleyOct 11, 2019
  5. Jeff KingOct 11, 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.