mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-11-27 07:37:33 +00:00
87 lines
3.2 KiB
Plaintext
87 lines
3.2 KiB
Plaintext
How to Maintain Copyright Years for GNU Emacs
|
|
|
|
|
|
"Our lawyer says it is ok if we add, to each file that has been in Emacs
|
|
since Emacs 21 came out in 2001, all the subsequent years[1]. We don't
|
|
need to check whether *that file* was changed in those years.
|
|
It's sufficient that *Emacs* was changed in those years (and it was!).
|
|
|
|
For those files that have been added since then, we should add
|
|
the year it was added to Emacs, and all subsequent years."
|
|
|
|
--RMS, 2005-07-13
|
|
|
|
[1] Note that this includes 2001 - see
|
|
<http://lists.gnu.org/archive/html/emacs-pretest-bug/2006-12/msg00119.html>
|
|
|
|
|
|
For the refcards under etc/, it's ok to simply use the latest year
|
|
(typically in a `\def\year{YEAR}' expression) for the rendered copyright
|
|
notice, while maintaining the full list of years in the copyright notice
|
|
in the comments.
|
|
|
|
|
|
Please fix or report any non-trivial files that have "odd" copyright
|
|
notices. This includes missing copyright notices, and copyright
|
|
holders other than FSF (or AIST in some cases). In most cases,
|
|
individual authors should not appear in copyright statements. Either
|
|
the copyright has been assigned (check copyright.list) to the FSF (in
|
|
which case the original author should be removed and the year(s)
|
|
transferred to the FSF); or else it is possible the file should not be
|
|
in Emacs at all (please report!).
|
|
|
|
When updating the copyright in a file (eg a .tex file) that generates
|
|
another file distributed with Emacs, don't forget to check in a
|
|
regenerated version of the target file.
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
Following is the policy that we tried to write down one time (mid 2005).
|
|
Although it is incorrect, we keep it around to remind us how complicated
|
|
things used to be (and may become in the future).
|
|
|
|
|
|
Principle: Individual files need to have the year of the release
|
|
in the copyright notice if there is significant change.
|
|
|
|
|
|
Practice:
|
|
|
|
- individual files
|
|
- each must be examined, along w/ its history, by a human
|
|
- automated tools facilitate but can never replace this process
|
|
|
|
- year of the release
|
|
- may be different from year of file introduction,
|
|
or year of last significant change
|
|
- sometimes the release year slips, leaving a file w/ prematurely
|
|
marked release year => need update (e.g., s/2004/2005/ for Emacs 22)
|
|
- intervening years (between releases) are not valid and may cause
|
|
embarrassment later in case of dispute => remove (however, see next)
|
|
- years for new files (merged, contributed) that have been separately
|
|
published are valid even if between releases => leave alone
|
|
|
|
- significant change
|
|
- insignificant
|
|
- whitespace
|
|
- copyright notice
|
|
- version control tags
|
|
- simple var/func renaming
|
|
- in-file reorganization/reordering
|
|
- typos
|
|
- small bugfixes
|
|
- small docfixes
|
|
- filename renaming
|
|
- most everything else is significant
|
|
- change to interface
|
|
- change in functionality
|
|
- new file
|
|
- many small changes may be significant in aggregate
|
|
|
|
- when in doubt, ask (and update these guidelines -- thanks!)
|
|
|
|
- sometimes people make mistakes
|
|
- if they have not read these guidelines, point them here
|
|
- if the guidelines are not helpful, improve the guidelines
|