On Wed, Jan 6, 2010 at 10:41 PM, Bruce Momjian <bruce@momjian.us> wrote:
> Alvaro Herrera wrote:
>> Bruce Momjian wrote:
>> > Alvaro Herrera wrote:
>>
>> > > I think this is a bad style to use for commit messages. For GIT, a good
>> > > commit message is a first line being a summary, and a more extensive
>> > > message below.
>> >
>> > That is just too odd. I think I forgot about the summary idea then.
>>
>> What is odd?
>>
>> If I was unclear, look at this status page:
>>
>> http://git.postgresql.org/gitweb?p=postgresql.git;a=shortlog
>>
>> Note that for your commit it only says "PG_MAJORVERSION:". You have to
>> open the patch's page to see the rest of the message.
>
> Well, having the description and then a blank line in the middle just is
> too odd for too small a group of viewers. I might as well just type the
> commit message as normal and users can see all they can.
It's not really that odd. You just write the message so that the
first line gives an overview of what has been done. If you have
additional details, then you skip a line and then write them out. For
example, in this case you might have written:
Simplify creation of the PG_VERSION file.
It makes more sense to use PG_MAJORVERSION rather than PG_VERSION for
this purpose.
This has exactly the same content as what you actually wrote, just
reworded so that the first line is a reasonable summary of the whole
message. It's not too hard once you get the knack of it.
...Robert