ChangeLog entry format

[Patrick Leslie Polzer]

Hello coders,

I'd like to suggest converting ChangeLog to the format advertised by the
GNU project.  Relevant passages:

"Separate unrelated change log entries with blank lines. When two
entries represent parts of the same change, so that they work together,
then don't put blank lines between them. Then you can omit the file
name and the asterisk when successive entries are in the same file." 

"Break long lists of function names by closing continued lines with `)',
rather than `,', and opening the continuation with `(' as in this
example:

 * keyboard.c (menu_bar_items, tool_bar_items)
(Fexecute_extended_command): Deal with `keymap' property."

"When you install someone else's changes, put the contributor's name in
the change log entry rather than in the text of the entry. In other
words, write this: 

 2002-07-14  John Doe  <address@hidden>

        * sewing.c: Make it sew.



rather than this: 

 2002-07-14  Usual Maintainer  <address@hidden>

        * sewing.c: Make it sew.  Patch by address@hidden"



Note the format:

2002-07-14  Usual Maintainer  <address@hidden>

<TAB/8spaces>* sewing.c: Make it sew.  Patch by address@hidden"
             (line continued below asterisk)


Any objections?

Leslie


-- 
gpg --keyserver pgp.mit.edu --recv-keys 0x52D70289

pgpO2gThTIlrs.pgp
Description: PGP signature