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

Re: [PATCH] Document "commit --only".

From
Nicolas Pitre <nico@cam.org>
Date
May 6, 2007, 23:13 UTC
Message-ID
<alpine.LFD.0.99.0705061908430.24220@xanadu.home>
In-Reply-To
<11784859184184-git-send-email-Matthieu.Moy@imag.fr>
On Sun, 6 May 2007, Matthieu Moy wrote:
Show 6 quoted lines
> The documentation was there earlier, but removed by
> 4170a19587280eeb3663a47a6fd993910de78076.
> 
> That option being the default now, it could perhaps be actually
> removed, but since it is there, and mentionned in the SYNOPSIS, it
> should be actually documented.
I don't think this is a good idea either.
> +-o|--only::
> +	Commit only the files specified on the command line.
> +	This format cannot be used during a merge. This is the
> +	default.

This looks really confusing. This is the default _only_ if files are specified on the command line.

IMHO I'd rather remove the option from the synopsis and flag it as scheduled for removal in the source instead.

Nicolas
Previous: Matthieu MoyNext: Matthieu Moy
Message 5 of 10 in “Document the fact that commit -a is the way to go for simple operations”
  1. Document the fact that commit -a is the way to go for simple operationsMatthieu Moy, May 6, 2007
  2. Document git add -u introduced earlier.Matthieu Moy, May 6, 2007
  3. Added a reference to git-add in the documentation for git-update-indexMatthieu Moy, May 6, 2007
  4. Document "commit --only".Matthieu Moy, May 6, 2007
  5. Nicolas PitreMay 6, 2007
  6. Matthieu MoyMay 7, 2007
  7. Matthieu MoyMay 7, 2007
  8. Nicolas PitreMay 6, 2007
  9. Matthieu MoyMay 7, 2007
  10. Johannes SchindelinMay 7, 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.