Nicolas Pitre <nico@xxxxxxx> writes: >> --- a/Documentation/git-commit.txt >> +++ b/Documentation/git-commit.txt >> @@ -54,7 +54,8 @@ OPTIONS >> -a|--all:: >> Tell the command to automatically stage files that have >> been modified and deleted, but new files you have not >> - told git about are not affected. >> + told git about are not affected. You should use it for most >> + trivial operations. > > I don't think this patch is worth it. If anything it might create more > confusion. > > There are many ways to commit without -a which still could be considered > amongst "most trivial operations". My proposal is not perfect, and I'm sure we can do better. But the problem with most of git's manpages for beginners is that the documentation is mostly technical and factual. That is, it tells you what git will do if you provide such or such option, but not _why_ and _when_ you should use it. Probably just a "gitlink:" to the place in the user manual which talks about the index would be OK here. -- Matthieu - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html