Re: FYI: changelog formatting notes [libtool--devo--1.0--patch-1]

[Gary V. Vaughan]

Alexandre Duret-Lutz wrote:
>>>>"Gary" == Gary V Vaughan <address@hidden> writes:
>
>
>  Gary> +* If the author of the change is different from the author of the
>  Gary> +  ChangeLog, then the change outhor should be credited, separated from
>  Gary> +  the previous field by a blank line and indented by 1 tab (note, only
>  Gary> +  1 space between fields here):
>  Gary> +
>  Gary> +      From Author of Actual Change <address@hidden>:
>  Gary> +
>
> The GNU Coding Standards say the converse:
>
> |    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
> |
> |    As for the date, that should be the date you applied the change.

Interesting.  As an incentive for occasional contributers to write their
own ChangeLog entry, I have long used the From Patch Author
<address@hidden>, if I've had to write the ChangeLog entry myself.  I
think it is quite a nice convention :-(

Should I stop doing that, and change the HACKING note to explain that
what is currently documented there is how to read ChangeLog.2004 or
earlier, and defer to the GCS?

Cheers,
        Gary.
--
Gary V. Vaughan      ())_.  address@hidden,gnu.org}
Research Scientist   ( '/   http://tkd.kicks-ass.net
GNU Hacker           / )=   http://www.gnu.org/software/libtool
Technical Author   `(_~)_   http://sources.redhat.com/autobook

signature.asc
Description: OpenPGP digital signature