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

Re: Convention for help in git commands?

From
Martin Langhoff <martin.langhoff@gmail.com>
Date
Oct 25, 2005, 22:07 UTC
Message-ID
<46a038f90510251507oe62ce42i86e6d4cf8200f20@mail.gmail.com>
In-Reply-To
<200510252335.47917.Josef.Weidendorfer@gmx.de>
On 10/26/05, Josef Weidendorfer <Josef.Weidendorfer@gmx.de> wrote:
Show 15 quoted lines
> On Tuesday 25 October 2005 22:24, you wrote:
> > On 10/26/05, Junio C Hamano <junkio@cox.net> wrote:
> > > > * For commands which need at least one argument, the usage
> > > > is also printed, if the command is run without argument
> > >
> > > This is slightly debatable.  I'd rather see it error out for one
> > > thing, and we might want to do a sane default given no arguments
> > > later.
> >
> > This could lead to subtle bugs when git is used by porcelains. If
> > there are going to be changes in default behaviours, let's have them
> > soon-ish ;-)
>
> What is the difference for a porcelain between error out,
> presumable with an error message, and printing the usage alone?

Sorry! My comment was aimed at the "do a sane default given no arguments later" part of Junio's post. Error vs help messages don't affect porcelains if you check your tty and avoid spitting out a help message when invoked from a script ;-)

cheers,
martin
Previous: Josef Weidendorfer
Message 5 of 5 in “Convention for help in git commands?”
  1. Josef WeidendorferOct 25, 2005
  2. Junio C HamanoOct 25, 2005
  3. Martin LanghoffOct 25, 2005
  4. Josef WeidendorferOct 25, 2005
  5. Martin LanghoffOct 25, 2005

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.