1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00

* admin/notes/years: Update.

This commit is contained in:
Stefan Kangas 2024-09-14 17:19:23 +02:00
parent 38de992a5a
commit 43b678d3d2

View file

@ -1,6 +1,6 @@
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 Maintaining copyright years is very simple: every time a new year
rolls around, add that year to every FSF (and AIST) copyright notice. 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 Do this by running the 'admin/update-copyright' script on a fresh repo
checkout, redirecting its output to a file, so that you could later 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:
etc/tutorials/TUTORIAL.ro for some reason etc/tutorials/TUTORIAL.ro for some reason
. it doesn't update the second Copyright notice, the one that gets . it doesn't update the second Copyright notice, the one that gets
output into PDF and PS, in etc/refcards/ru-refcard.tex output into PDF and PS, in etc/refcards/ru-refcard.tex
. it doesn't update etc/refcards/gnus-refcard.tex and . it doesn't update etc/refcards/gnus-refcard.tex, doc/misc/org.org,
doc/misc/org.org because their Copyright statements have a nt/emacs.rc.in, and nt/emacsclient.rc.in, because their Copyright
non-standard format statements have a non-standard format
. several README and XPM files under etc/images/, and also . several README files under etc/images/, and also
etc/refcards/README, msdos/README, and nt/icons/README aren't etc/refcards/README, msdos/README, and nt/icons/README aren't
updated either updated either
- the copyright notice for headers generated by exec/configure.ac is . the copyright notices for headers generated by configure.ac and
not updated as the file already bears a notice above it exec/configure.ac are not updated as the files already bear notices
above them
. the example copyright year in doc/lispref/tips.texi is not updated
These files need to be updated by hand. These files need to be updated by hand, however note that the above list
is not necessarily exhaustive. For that reason, it's best to grep for
something like "\<202[0-4]\>" and check any hits manually.
Next, run "M-x set-copyright" from admin.el, which updates several Next, run "M-x set-copyright" from admin.el, which updates several
copyright notices in the Emacs sources. copyright notices in the Emacs sources.
@ -40,23 +44,21 @@ ETAGS.good* and CTAGS.good files, and then commit the new test files.
There's no need to worry about whether an individual file has changed 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. 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, 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. 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 The refcards in etc/refcards can print only the latest copyright year,
Software" (see that document for more details) says that it is OK to use but should keep the full list in a comment in the source.
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 For more detailed information on maintaining copyright, see the file
"copyright" in this directory. "copyright" in this directory.
The previous policy was more complex, but is now only of historical The previous policy was more complex, but is now only of historical
interest (see versions of this file from before 2009). interest (see versions of this file from before 2009). In early 2011,
the years were changed to use ranges. This is OK according to changes
made to "Information for Maintainers of GNU Software" that same year
(see that document for more details).
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 "Our lawyer says it is ok if we add, to each file that has been in Emacs