[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
FYI: describe changelog attributions as per GCS [libtool--devo--1.0--pat
From: |
Gary V. Vaughan |
Subject: |
FYI: describe changelog attributions as per GCS [libtool--devo--1.0--patch-5] |
Date: |
Sun, 9 Jan 2005 13:33:15 +0000 (GMT) |
User-agent: |
mailnotify/0.6 |
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Applied to HEAD.
* looking for address@hidden/libtool--devo--1.0--patch-4 to compare with
* comparing to address@hidden/libtool--devo--1.0--patch-4
M HACKING
M ChangeLog
* modified files
Index: Changelog
from Gary V. Vaughan <address@hidden>
* HACKING (Editing 'ChangeLog'): Follow the GCS with respect to
attributions, and mention how to handle tiny changes.
Reported by Alexandre Duret-Lutz <address@hidden>.
--- orig/HACKING
+++ mod/HACKING
@@ -85,26 +85,36 @@
yyyy-mm-dd Name of Author <address@hidden>
-* 'Name of Author' is the name of the person who made the change being
- documented, or if that person didn't supply a ChangeLog, the author
- of the ChangeLog entry. If more than one person collaborated on the
- change, additional authors can be listed on subsequent lines, thus:
+* If more than one person collaborated on the change, additional
+ authors can be listed on subsequent lines, thus:
yyyy-mm-dd Name of Main Author <address@hidden>,
Name of Contributor <address@hidden>
+* Where a change author did not supply a copyright assignment, but the
+ changes they submitted were sufficiently trivial to commit in any case
+ (see the GCS for guidelines on this), then flag this against their
+ name in the header, thus:
+
+yyyy-mm-dd Name of Author <address@hidden> (tiny change)
+
+* In ChangeLog.2004 and earlier, 'Name of Author' was sometimes the name
+ of the author of the ChangeLog when the person who made the change
+ being documented didn't supply one. In that case separated from
+ the previous field by a blank line and indented by 1 tab (note, only
+ 1 space between fields here) you will see:
+
+ From Author of Actual Change <address@hidden>:
+
+ As of now, don't do that anymore, since the GNU Coding Standards say
+ that the author of the change must be credited in the main entry
+ header for legal purposes.
+
* Preferably the next part should be a description of the overall
purpose of the change, separated from the header by a blank line,
indented by 1 tab, and filled at column 72. The last character of the
description should be a colon, :.
-* If the author of the change is different from the author of the
- ChangeLog, then the change outhor should be credited, separated from
- the previous field by a blank line and indented by 1 tab (note, only
- 1 space between fields here):
-
- From Author of Actual Change <address@hidden>:
-
* Changes to each file come next. Each new file starts on a new line,
indented by 1 tab and starting with an asterisk and a space. Multiple
files can be listed here relative to $top_srcdir, and comma separated.
@@ -145,13 +155,12 @@
formatting.
-2005-01-08 Gary V. Vaughan <address@hidden>,
+2005-01-08 Ralf Wildenhues <address@hidden> (tiny change),
Peter O'Gorman <address@hidden>
This is the overall description of the purpose of this change
and any useful background for a model ChangeLog entry:
- From Ralf Wildenhues <address@hidden>:
* HACKING: Updated copyright. This isn't attached to a
particular section of the file, so it comes first.
(Editing 'ChangeLog'): New section. This applies to the same
- --
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
_________________________________________________________
This patch notification generated by tlaapply version 0.9
http://tkd.kicks-ass.net/arch/address@hidden/cvs-utils--tla--1.0
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (Darwin)
iD8DBQFB4TKaFRMICSmD1gYRAvPcAJ9/IdNiOn/gnYR1hfMbAJ9dkR3pyQCgsMJe
0Hft+REKtKxVj2k+g8n2YSY=
=SGGF
-----END PGP SIGNATURE-----
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- FYI: describe changelog attributions as per GCS [libtool--devo--1.0--patch-5],
Gary V. Vaughan <=