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

Re: [PATCH] Documentation/git-commit: rewrite to make it more end-user friendly.

From
Nicolas Pitre <nico@cam.org>
Date
Dec 10, 2006, 22:07 UTC
Message-ID
<Pine.LNX.4.64.0612101704390.2630@xanadu.home>
In-Reply-To
<20061210210057.GB23387@fieldses.org>
On Sun, 10 Dec 2006, J. Bruce Fields wrote:
Show 5 quoted lines
> Or maybe: "by using gitlink:git-add[1] to add new content (of either new
> or newly modified files) to the next commit."
> 
> Man pages are reference documentation, so I figure it's OK to sacrifice
> a little newbie-friendliness for accuracy and concision.

I disagree. Clarity should be the first goal. And the fact that even modified files have to be specified is something worth enphasizing, especially since this is not something other systems do.

Previous: J. Bruce FieldsNext: J. Bruce Fields
Message 21 of 25 in “Documentation/git-commit.txt”
  1. Junio C HamanoDec 8, 2006
  2. Salikh ZakirovDec 8, 2006
  3. Junio C HamanoDec 8, 2006
  4. Nicolas PitreDec 8, 2006
  5. Alan ChandlerDec 8, 2006
  6. Nicolas PitreDec 9, 2006
  7. Junio C HamanoDec 9, 2006
  8. J. Bruce FieldsDec 9, 2006
  9. Nicolas PitreDec 9, 2006
  10. Jakub NarebskiDec 9, 2006
  11. Documentation/git-commit: rewrite to make it more end-user friendly.Junio C Hamano, Dec 9, 2006
  12. Nicolas PitreDec 9, 2006
  13. Junio C HamanoDec 9, 2006
  14. Jakub NarebskiDec 9, 2006
  15. Linus TorvaldsDec 9, 2006
  16. Jakub NarebskiDec 9, 2006
  17. Nicolas PitreDec 9, 2006
  18. Josef WeidendorferDec 10, 2006
  19. Nicolas PitreDec 10, 2006
  20. J. Bruce FieldsDec 10, 2006
  21. Nicolas PitreDec 10, 2006
  22. J. Bruce FieldsDec 10, 2006
  23. Junio C HamanoDec 10, 2006
  24. Alan ChandlerDec 10, 2006
  25. J. Bruce FieldsDec 9, 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.