diff options
Diffstat (limited to 'admin/notes')
| -rw-r--r-- | admin/notes/years | 39 |
1 files changed, 20 insertions, 19 deletions
diff --git a/admin/notes/years b/admin/notes/years index 2a961536da6..9c0b9a81886 100644 --- a/admin/notes/years +++ b/admin/notes/years | |||
| @@ -1,6 +1,6 @@ | |||
| 1 | HOW TO MAINTAIN COPYRIGHT YEARS FOR GNU EMACS | 1 | HOW TO MAINTAIN COPYRIGHT YEARS FOR GNU EMACS |
| 2 | 2 | ||
| 3 | Maintaining copyright years is now very simple: every time a new year | 3 | Maintaining copyright years is very simple: every time a new year |
| 4 | rolls around, add that year to every FSF (and AIST) copyright notice. | 4 | rolls around, add that year to every FSF (and AIST) copyright notice. |
| 5 | Do this by running the 'admin/update-copyright' script on a fresh repo | 5 | Do this by running the 'admin/update-copyright' script on a fresh repo |
| 6 | checkout, redirecting its output to a file, so that you could later | 6 | checkout, redirecting its output to a file, so that you could later |
| @@ -20,16 +20,19 @@ A few known problems with the build-aux/update-copyright script: | |||
| 20 | . it doesn't update the second Copyright notice, the one that gets | 20 | . it doesn't update the second Copyright notice, the one that gets |
| 21 | output into PDF and PS, in etc/refcards/ru-refcard.tex | 21 | output into PDF and PS, in etc/refcards/ru-refcard.tex |
| 22 | . it doesn't update etc/refcards/gnus-refcard.tex, doc/misc/org.org, | 22 | . it doesn't update etc/refcards/gnus-refcard.tex, doc/misc/org.org, |
| 23 | and nt/*.rc.in because their Copyright statements have a | 23 | nt/emacs.rc.in, and nt/emacsclient.rc.in, because their Copyright |
| 24 | non-standard format | 24 | statements have a non-standard format |
| 25 | . several README and XPM files under etc/images/ | 25 | . several README files under etc/images/, and also |
| 26 | (e.g. etc/images/gud/README), and also etc/refcards/README, | 26 | etc/refcards/README, msdos/README, and nt/icons/README aren't |
| 27 | msdos/README, and nt/icons/README aren't updated either | 27 | updated either |
| 28 | - the copyright notices for headers generated by exec/configure.ac and | 28 | . the copyright notices for headers generated by configure.ac and |
| 29 | by configure.ac are not updated as the file already bears a notice | 29 | exec/configure.ac are not updated as the files already bear notices |
| 30 | above it | 30 | above them |
| 31 | 31 | . the example copyright year in doc/lispref/tips.texi is not updated | |
| 32 | These files need to be updated by hand. | 32 | |
| 33 | These files need to be updated by hand, however note that the above list | ||
| 34 | is not necessarily exhaustive. For that reason, it's best to grep for | ||
| 35 | something like "\<202[0-4]\>" and check any hits manually. | ||
| 33 | 36 | ||
| 34 | Next, run "M-x set-copyright" from admin.el, which updates several | 37 | Next, run "M-x set-copyright" from admin.el, which updates several |
| 35 | copyright notices in the Emacs sources. | 38 | copyright notices in the Emacs sources. |
| @@ -42,23 +45,21 @@ ETAGS.good* and CTAGS.good files, and then commit the new test files. | |||
| 42 | 45 | ||
| 43 | There's no need to worry about whether an individual file has changed | 46 | There's no need to worry about whether an individual file has changed |
| 44 | in a given year - it's sufficient that Emacs as a whole has changed. | 47 | in a given year - it's sufficient that Emacs as a whole has changed. |
| 45 | |||
| 46 | Therefore the years are updated en-masse near the start of each year, | 48 | Therefore the years are updated en-masse near the start of each year, |
| 47 | so basically there is no need for most people to do any updating of them. | 49 | so basically there is no need for most people to do any updating of them. |
| 48 | 50 | ||
| 49 | The current (in 2011) version of "Information for Maintainers of GNU | 51 | The refcards in etc/refcards can print only the latest copyright year, |
| 50 | Software" (see that document for more details) says that it is OK to use | 52 | but should keep the full list in a comment in the source. |
| 51 | ranges in copyright years, so in early 2011 the years were changed to use | ||
| 52 | ranges, which occupy less space and do not grow in length every year. | ||
| 53 | 53 | ||
| 54 | For more detailed information on maintaining copyright, see the file | 54 | For more detailed information on maintaining copyright, see the file |
| 55 | "copyright" in this directory. | 55 | "copyright" in this directory. |
| 56 | 56 | ||
| 57 | The previous policy was more complex, but is now only of historical | 57 | The previous policy was more complex, but is now only of historical |
| 58 | interest (see versions of this file from before 2009). | 58 | interest (see versions of this file from before 2009). In early 2011, |
| 59 | the years were changed to use ranges. This is OK according to changes | ||
| 60 | made to "Information for Maintainers of GNU Software" that same year | ||
| 61 | (see that document for more details). | ||
| 59 | 62 | ||
| 60 | The refcards in etc/refcards can print only the latest copyright year, | ||
| 61 | but should keep the full list in a comment in the source. | ||
| 62 | 63 | ||
| 63 | 64 | ||
| 64 | "Our lawyer says it is ok if we add, to each file that has been in Emacs | 65 | "Our lawyer says it is ok if we add, to each file that has been in Emacs |