* jesse <jesse@fsck.com> [2009-12-30 21:55]:
> (That C<-a> tells git to add every file you've changed to this
> commit. If you want to commit some, but not all of your
> changes, have a look at the documentation for C<git add>.)
If you’re going to explain this, then I think it’s important to
tell people that `-a` won’t add new files, rather than let them
learn this by way of a few oopses:
(The C<-a> switch tells git to include every file you've
changed in this commit. Note that it won't include new files!
If you have new files or you want to commit only some, but
not all of your changes, have a look at the documentation for
C<git add>.)
> Your commit message should start with a description of the
> problem that the patch corrects or new functionality that the
> patch adds.
I think this isn’t explicit enough, and I think it should say
something like this:
Write a concise summary of the problem that your patch
corrects or new functionality that your patch adds on the
first line of your commit message.
In many circumstances, git shows only this first line; think
of it as the subject line of the commit message. If your
patch needs more explanation, write it out after a blank line
following the subject.
Regards,
--
Aristotle Pagaltzis // <http://plasmasturm.org/>
Thread Previous
|
Thread Next