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

Usability question

From
RBRob Barrett <barrettboy@gmail.com>
Date
Sep 17, 2009, 10:01 UTC
Message-ID
<513ca40e0909170301s2b09184akb27acde76975c09b@mail.gmail.com>

When starting with git people almost always ask some variant of "how do I know whether this option should be prefixed with dashes or not?" i.e. git reset --hard vs. git stash save --patch, which coupled with other path, sha and treeish args make things a bit more confusing.

Not sure if this has been discussed before? If it has point me at the discussion and I'll go look at it -- no need to read further.

And people stop asking the question after they get used to git - but that's not the same as being usable.

Out of 60+ commands, most take the form git <subcommand> [--option] and a few take the form git <subcommand> subsubcommand [--option]

(a quick scan gives: bisect,bundle,reflog,remote,stash)
My questions:
1. What is the distinction that makes the 10% special enough to get
non-prefixed options?
2. Is it worthwhile? Wouldn't it be better if to shoot for more
consistency / less complexity?
Rob
Next: Matthieu Moy
Message 1 of 8 in “Usability question”
  1. Rob BarrettSep 17, 2009
  2. Matthieu MoySep 17, 2009
  3. SZEDER GáborSep 17, 2009
  4. Matthieu MoySep 17, 2009
  5. Daniele SegatoSep 17, 2009
  6. Rob BarrettSep 20, 2009
  7. Dmitry PotapovSep 20, 2009
  8. Owen TaylorSep 17, 2009

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.