]> code.delx.au - gnu-emacs/blobdiff - admin/notes/years
; Merge from origin/emacs-25
[gnu-emacs] / admin / notes / years
index 7000f0942c10761ed3c88bbd104a89eae3e47d5c..c0db1854e30586d57003b4bd79c8399ccbcc123e 100644 (file)
@@ -1,4 +1,29 @@
-How to Maintain Copyright Years for GNU Emacs
+HOW TO MAINTAIN COPYRIGHT YEARS FOR GNU EMACS
+
+Maintaining copyright years is now very simple: every time a new year
+rolls around, add that year to every FSF (and AIST) copyright notice.
+Do this by running the 'admin/update-copyright' script on a fresh repo
+checkout.  Inspect the results for plausibility, then commit them.
+
+There's no need to worry about whether an individual file has changed
+in a given year - it's sufficient that Emacs as a whole has changed.
+
+Therefore the years are updated en-masse near the start of each year,
+so basically there is no need for most people to do any updating of them.
+
+The current (in 2011) version of "Information for Maintainers of GNU
+Software" (see that document for more details) says that it is OK to use
+ranges in copyright years, so in early 2011 the years were changed to use
+ranges, which occupy less space and do not grow in length every year.
+
+For more detailed information on maintaining copyright, see the file
+"copyright" in this directory.
+
+The previous policy was more complex, but is now only of historical
+interest (see versions of this file from before 2009).
+
+The refcards in etc/refcards can print only the latest copyright year,
+but should keep the full list in a comment in the source.
 
 
 "Our lawyer says it is ok if we add, to each file that has been in Emacs
@@ -13,71 +38,3 @@ How to Maintain Copyright Years for GNU Emacs
 
 [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!).
-
-
-------------------------------------------------------------------------------
-
-
-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