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

Re: [PATCH] Document git-runstatus

From
Sean <seanlkml@sympatico.ca>
Date
Nov 18, 2006, 16:04 UTC
Message-ID
<BAYC1-PASMTP06C814AB518D7544770C01AEEF0@CEZ.ICE>
In-Reply-To
<455F210B.8000107@lsrfire.ath.cx>

On Sat, 18 Nov 2006 16:04:43 +0100 Rene Scharfe <rene.scharfe@lsrfire.ath.cx> wrote:

> git-status is a wrapper around git-runstatus that takes the same
> options as git-commit.  It could have been named 'git-commit --dry-run'.

What could be said in the docs as to when the use of one is preferred over the other?

> > All commands deserve a man page.
> 
> Exactly.  Even plumbers read manuals ;-).  Well, me at least.

Heh, I suppose you and Petr are right. It's just that in recent discussions the great number of commands provided by Git is seen as a UI problem. Thus having two commands that seem to do the exact same thing gives more such pain for no gain.

It's possible that plumbers should not be seen as "users" but rather as coders capable of reading traditional text based (non man-page) documentation for their purposes, and man pages should only exist (or at least installed) for user level commands.

Previous: Rene ScharfeNext: A Large Angry SCM
Message 5 of 12 in “Document git-runstatus”
  1. Document git-runstatusRene Scharfe, Nov 18, 2006
  2. SeanNov 18, 2006
  3. Petr BaudisNov 18, 2006
  4. Rene ScharfeNov 18, 2006
  5. SeanNov 18, 2006
  6. A Large Angry SCMNov 18, 2006
  7. SeanNov 18, 2006
  8. Junio C HamanoNov 18, 2006
  9. SeanNov 18, 2006
  10. Petr BaudisNov 19, 2006
  11. Joshua N PritikinNov 20, 2006
  12. Jakub NarebskiNov 20, 2006

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.