Mercurial > emacs
annotate admin/notes/years @ 75344:eb388ac3f2f1
*** empty log message ***
author | Glenn Morris <rgm@gnu.org> |
---|---|
date | Sun, 21 Jan 2007 00:39:49 +0000 |
parents | f3a5f0fb3297 |
children | 04d493c77655 |
rev | line source |
---|---|
64680
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
1 How to Maintain Copyright Years for GNU Emacs |
62697 | 2 |
3 | |
64680
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
4 "Our lawyer says it is ok if we add, to each file that has been in Emacs |
75251 | 5 since Emacs 21 came out in 2001, all the subsequent years[1]. We don't |
64680
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
6 need to check whether *that file* was changed in those years. |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
7 It's sufficient that *Emacs* was changed in those years (and it was!). |
62697 | 8 |
64680
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
9 For those files that have been added since then, we should add |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
10 the year it was added to Emacs, and all subsequent years." |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
11 |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
12 --RMS, 2005-07-13 |
62697 | 13 |
75251 | 14 [1] Note that this includes 2001 - see |
15 <http://lists.gnu.org/archive/html/emacs-pretest-bug/2006-12/msg00119.html> | |
16 | |
62697 | 17 |
65217
c062f0fb51ba
Mention rendered/commented copyright notice practice
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64680
diff
changeset
|
18 For the refcards under etc/, it's ok to simply use the latest year |
c062f0fb51ba
Mention rendered/commented copyright notice practice
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64680
diff
changeset
|
19 (typically in a `\def\year{YEAR}' expression) for the rendered copyright |
c062f0fb51ba
Mention rendered/commented copyright notice practice
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64680
diff
changeset
|
20 notice, while maintaining the full list of years in the copyright notice |
c062f0fb51ba
Mention rendered/commented copyright notice practice
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64680
diff
changeset
|
21 in the comments. |
c062f0fb51ba
Mention rendered/commented copyright notice practice
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64680
diff
changeset
|
22 |
c062f0fb51ba
Mention rendered/commented copyright notice practice
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
64680
diff
changeset
|
23 |
75251 | 24 Please fix or report any non-trivial files that have "odd" copyright |
25 notices. This includes missing copyright notices, and copyright | |
26 holders other than FSF (or AIST in some cases). In most cases, | |
27 individual authors should not appear in copyright statements. Either | |
28 the copyright has been assigned (check copyright.list) to the FSF (in | |
29 which case the original author should be removed and the year(s) | |
30 transferred to the FSF); or else it is possible the file should not be | |
31 in Emacs at all (please report!). | |
32 | |
75344 | 33 When updating the copyright in a file (eg a .tex file) that generates |
34 another file distributed with Emacs, don't forget to check in a | |
35 regenerated version of the target file. | |
75251 | 36 |
64680
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
37 ------------------------------------------------------------------------------ |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
38 |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
39 |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
40 Following is the policy that we tried to write down one time (mid 2005). |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
41 Although it is incorrect, we keep it around to remind us how complicated |
32b32ccdedc0
Update. Include emacs-devel message fragment.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
62697
diff
changeset
|
42 things used to be (and may become in the future). |
62464 | 43 |
44 | |
45 Principle: Individual files need to have the year of the release | |
46 in the copyright notice if there is significant change. | |
47 | |
48 | |
49 Practice: | |
50 | |
51 - individual files | |
52 - each must be examined, along w/ its history, by a human | |
53 - automated tools facilitate but can never replace this process | |
54 | |
55 - year of the release | |
56 - may be different from year of file introduction, | |
57 or year of last significant change | |
58 - sometimes the release year slips, leaving a file w/ prematurely | |
59 marked release year => need update (e.g., s/2004/2005/ for Emacs 22) | |
60 - intervening years (between releases) are not valid and may cause | |
61 embarrassment later in case of dispute => remove (however, see next) | |
62 - years for new files (merged, contributed) that have been separately | |
63 published are valid even if between releases => leave alone | |
64 | |
65 - significant change | |
66 - insignificant | |
67 - whitespace | |
68 - copyright notice | |
69 - version control tags | |
70 - simple var/func renaming | |
71 - in-file reorganization/reordering | |
72 - typos | |
73 - small bugfixes | |
74 - small docfixes | |
75 - filename renaming | |
76 - most everything else is significant | |
77 - change to interface | |
78 - change in functionality | |
79 - new file | |
80 - many small changes may be significant in aggregate | |
81 | |
82 - when in doubt, ask (and update these guidelines -- thanks!) | |
83 | |
84 - sometimes people make mistakes | |
85 - if they have not read these guidelines, point them here | |
86 - if the guidelines are not helpful, improve the guidelines |