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

Re: [PATCH v2] standardize usage info string format

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 13, 2015, 22:45 UTC
Message-ID
<xmqqegqycnbd.fsf@gitster.dls.corp.google.com>
In-Reply-To
<1421135087-7284-1-git-send-email-alexhenrie24@gmail.com>
Alex Henrie <alexhenrie24@gmail.com> writes:
Show 17 quoted lines
> This patch puts the usage info strings that were not already in docopt-
> like format into docopt-like format, which will be a litle easier for
> end users and a lot easier for translators. Changes include:
>
> - Placing angle brackets around fill-in-the-blank parameters
> - Putting dashes in multiword parameter names
> - Adding spaces to [-f|--foobar] to make [-f | --foobar]
> - Replacing <foobar>* with [<foobar>...]
>
> Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
> ---
>  Documentation/CodingGuidelines |  8 ++++++--
>  advice.c                       |  2 +-
>  archive.c                      |  4 ++--
>  ...
>  git.c                          |  2 +-
>  64 files changed, 109 insertions(+), 105 deletions(-)

A patch that affects this many files is bound to interfere with a few topics already in flight, but after applying it on top of 2.3-rc0 and then merging the result to 'pu', the textual conflicts are still manageable.

I eyeballed it briefly and saw nothing glaringly wrong. Let's give others some time to glance it over.

Thanks (and thanks to those who read the previous iteration).
Previous: Alex HenrieNext: Matthieu Moy
Message 3 of 5 in “standardize usage info string format”
  1. standardize usage info string formatAlex Henrie, Jan 13, 2015
  2. Alex HenrieJan 13, 2015
  3. Junio C HamanoJan 13, 2015
  4. Matthieu MoyJan 14, 2015
  5. Junio C HamanoJan 14, 2015

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.