diff options
| author | Stefan Kangas | 2024-09-14 17:19:23 +0200 |
|---|---|---|
| committer | Stefan Kangas | 2024-09-14 17:32:59 +0200 |
| commit | 43b678d3d26b62d112fde286d0bf077954b28afa (patch) | |
| tree | 07e9b6185a70eb28ee210dc665add7fc184a0aab /admin | |
| parent | 38de992a5a3ff13c6c727fd519b3f016f15264ea (diff) | |
| download | emacs-43b678d3d26b62d112fde286d0bf077954b28afa.tar.gz emacs-43b678d3d26b62d112fde286d0bf077954b28afa.zip | |
* admin/notes/years: Update.
Diffstat (limited to 'admin')
| -rw-r--r-- | admin/notes/years | 34 |
1 files changed, 18 insertions, 16 deletions
diff --git a/admin/notes/years b/admin/notes/years index 0510cb24b81..324cc4793d3 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 |
| @@ -18,16 +18,20 @@ A few known problems with the build-aux/update-copyright script: | |||
| 18 | etc/tutorials/TUTORIAL.ro for some reason | 18 | etc/tutorials/TUTORIAL.ro for some reason |
| 19 | . it doesn't update the second Copyright notice, the one that gets | 19 | . it doesn't update the second Copyright notice, the one that gets |
| 20 | output into PDF and PS, in etc/refcards/ru-refcard.tex | 20 | output into PDF and PS, in etc/refcards/ru-refcard.tex |
| 21 | . it doesn't update etc/refcards/gnus-refcard.tex and | 21 | . it doesn't update etc/refcards/gnus-refcard.tex, doc/misc/org.org, |
| 22 | doc/misc/org.org because their Copyright statements have a | 22 | nt/emacs.rc.in, and nt/emacsclient.rc.in, because their Copyright |
| 23 | non-standard format | 23 | statements have a non-standard format |
| 24 | . several README and XPM files under etc/images/, and also | 24 | . several README files under etc/images/, and also |
| 25 | etc/refcards/README, msdos/README, and nt/icons/README aren't | 25 | etc/refcards/README, msdos/README, and nt/icons/README aren't |
| 26 | updated either | 26 | updated either |
| 27 | - the copyright notice for headers generated by exec/configure.ac is | 27 | . the copyright notices for headers generated by configure.ac and |
| 28 | not updated as the file already bears a notice above it | 28 | exec/configure.ac are not updated as the files already bear notices |
| 29 | above them | ||
| 30 | . the example copyright year in doc/lispref/tips.texi is not updated | ||
| 29 | 31 | ||
| 30 | These files need to be updated by hand. | 32 | These files need to be updated by hand, however note that the above list |
| 33 | is not necessarily exhaustive. For that reason, it's best to grep for | ||
| 34 | something like "\<202[0-4]\>" and check any hits manually. | ||
| 31 | 35 | ||
| 32 | Next, run "M-x set-copyright" from admin.el, which updates several | 36 | Next, run "M-x set-copyright" from admin.el, which updates several |
| 33 | copyright notices in the Emacs sources. | 37 | copyright notices in the Emacs sources. |
| @@ -40,23 +44,21 @@ ETAGS.good* and CTAGS.good files, and then commit the new test files. | |||
| 40 | 44 | ||
| 41 | There's no need to worry about whether an individual file has changed | 45 | There's no need to worry about whether an individual file has changed |
| 42 | in a given year - it's sufficient that Emacs as a whole has changed. | 46 | in a given year - it's sufficient that Emacs as a whole has changed. |
| 43 | |||
| 44 | Therefore the years are updated en-masse near the start of each year, | 47 | Therefore the years are updated en-masse near the start of each year, |
| 45 | so basically there is no need for most people to do any updating of them. | 48 | so basically there is no need for most people to do any updating of them. |
| 46 | 49 | ||
| 47 | The current (in 2011) version of "Information for Maintainers of GNU | 50 | The refcards in etc/refcards can print only the latest copyright year, |
| 48 | Software" (see that document for more details) says that it is OK to use | 51 | but should keep the full list in a comment in the source. |
| 49 | ranges in copyright years, so in early 2011 the years were changed to use | ||
| 50 | ranges, which occupy less space and do not grow in length every year. | ||
| 51 | 52 | ||
| 52 | For more detailed information on maintaining copyright, see the file | 53 | For more detailed information on maintaining copyright, see the file |
| 53 | "copyright" in this directory. | 54 | "copyright" in this directory. |
| 54 | 55 | ||
| 55 | The previous policy was more complex, but is now only of historical | 56 | The previous policy was more complex, but is now only of historical |
| 56 | interest (see versions of this file from before 2009). | 57 | interest (see versions of this file from before 2009). In early 2011, |
| 58 | the years were changed to use ranges. This is OK according to changes | ||
| 59 | made to "Information for Maintainers of GNU Software" that same year | ||
| 60 | (see that document for more details). | ||
| 57 | 61 | ||
| 58 | The refcards in etc/refcards can print only the latest copyright year, | ||
| 59 | but should keep the full list in a comment in the source. | ||
| 60 | 62 | ||
| 61 | 63 | ||
| 62 | "Our lawyer says it is ok if we add, to each file that has been in Emacs | 64 | "Our lawyer says it is ok if we add, to each file that has been in Emacs |