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

Re: [PATCH] git-rev-list.txt: rev stands for revision, not reverse.

From
Junio C Hamano <gitster@pobox.com>
Date
Nov 1, 2007, 19:51 UTC
Message-ID
<7vr6j9bv80.fsf@gitster.siamese.dyndns.org>
In-Reply-To
<20071101084552.GA4934@ins.uni-bonn.de>
Ralf Wildenhues <Ralf.Wildenhues@gmx.de> writes:
Show 10 quoted lines
> Mention revs, revisions as aliases for commit objects,
> to clarify that rev-list is not an abbreviation for
> listing in reverse order, but for listing revisions.
> ---
> Yes, believe it or not, but I stumbled over the synopsis
>
> | git-rev-list - Lists commit objects in reverse chronological order
>
> asking myself whether rev could possibly mean "reverse".
> I hope this helps avoid this pitfall for others.
In addition to your patch,
	git-rev-list - List commits from most recent to older

might be a good rewording? "rev-list --reverse" reverses that usual order and we end up explaining double reversal if we use the phrase "reverse chronological order" to describe the normal order.

Previous: Ralf WildenhuesNext: Ralf Wildenhues
Message 2 of 5 in “git-rev-list.txt: rev stands for revision, not reverse.”
  1. git-rev-list.txt: rev stands for revision, not reverse.Ralf Wildenhues, Nov 1, 2007
  2. Junio C HamanoNov 1, 2007
  3. Ralf WildenhuesNov 2, 2007
  4. Junio C HamanoNov 2, 2007
  5. Junio C HamanoNov 2, 2007

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.