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

Re: [RFC/PATCH 0/3] Documentation: Improve revision documentation

From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date
Jul 5, 2010, 17:26 UTC
Message-ID
<AANLkTinEHbNFv-x1e4f6Jfi7sodNGSlKIPJMctFDSG7k@mail.gmail.com>
In-Reply-To
<cover.1278346173.git.git@drmicha.warpmail.net>
On Mon, Jul 5, 2010 at 16:11, Michael J Gruber <git@drmicha.warpmail.net> wrote:
> This mini-series sets up a new gitrevisions(7) man page so that people
> looking for revision syntax don't need to try to find it in
> git-rev-parse(1) which is cluttered with a lot of unrelated stuff (it's
> plumbing after all).

I like this series a lot. I often forget what our revision behavior is and whether it's documented in git-rev-list, git-rev-parse or something else. Then when I finally find it in git-rev-parse I have to page down the manpage to discover it.

This is definitely something that should be standalone in gitrevisions(7).

Acked-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Previous: Michael J Gruber
Message 8 of 8 in “Documentation: Improve revision documentation”
  1. 0/3 Documentation: Improve revision documentationMichael J Gruber, Jul 5, 2010
  2. 1/3 Documentation: split off rev doc into include fileMichael J Gruber, Jul 5, 2010
  3. 2/3 Documentation: gitrevisionsMichael J Gruber, Jul 5, 2010
  4. Stephen BoydJul 14, 2010
  5. Michael J GruberJul 14, 2010
  6. Stephen BoydJul 14, 2010
  7. 3/3 Documentation: link to gitrevisions rather than git-rev-parseMichael J Gruber, Jul 5, 2010
  8. Ævar Arnfjörð BjarmasonJul 5, 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.