Please consider putting the change summary in the very first line of the
commit message, rather than just the subsystem ID.  For example, prefer
this:

    [foobar] Fix compile under VoodooCC
    * Frobnicated the whosit
    * Defenestrated the whatsit
    * Sacrificed a chicken under a full blue moon

Rather than this:

    [foobar]
    Fix compile under VoodooCC:
    * Frobnicated the whosit
    * Defenestrated the whatsit
    * Sacrificed a chicken under a full blue moon

A number of tools display only the first line of the commit message when
displaying lists of changes.  With only the subsystem IDs in the first
line, such lists look like this:

    [foobar]
    [baz]
    [quux]
    [quux]
    [xyzzy]

That doesn't help much, aside from seeing what subsystems are getting
attention lately.

See the attached screenshot for an example seen in gitk.


-'f

<<attachment: gitk-parrot.png>>

Reply via email to