Re: [RFA/doc] New Year Procedure

[Joel Brobecker <brobecker@adacore.com>]

[-- Attachment #1: Type: text/plain, Size: 258 bytes --]

Hi Eli,

I agree with all of your comments. Here is a new patch with all your
recommendations applied.

2005-11-24  Joel Brobecker  <brobecker@adacore.com>

        * gdbint.texinfo (Start of New Year Procedure): New chapter.

OK to apply?

Thanks,
-- 
Joel

[-- Attachment #2: doc.diff --]
[-- Type: text/plain, Size: 1619 bytes --]

Index: gdbint.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v
retrieving revision 1.230
diff -u -p -r1.230 gdbint.texinfo
--- gdbint.texinfo	10 Apr 2005 21:20:27 -0000	1.230
+++ gdbint.texinfo	24 Nov 2005 23:54:50 -0000
@@ -86,6 +86,7 @@ as the mechanisms that adapt @value{GDBN
 * Coding::
 * Porting GDB::
 * Versions and Branches::
+* Start of New Year Procedure::
 * Releasing GDB::
 * Testsuite::
 * Hints::
@@ -5598,6 +5599,38 @@ merge.
 For further information on @sc{cvs}, see
 @uref{http://www.gnu.org/software/cvs/, Concurrent Versions System}.
  
+@node Start of New Year Procedure
+@chapter Start of New Year Procedure
+@cindex New Year Procedure
+
+At the start of each new year, the following actions should be performed:
+
+@itemize @bullet
+@item
+Rotate the ChangeLog file
+
+The current @file{ChangeLog} file should be renamed into
+@file{ChangeLog-YYYY} where YYYY is the year that has just passed.
+A new @file{ChangeLog} file should be created, and its contents should
+contain a reference to the previous ChangeLog. The following should
+also be preserved at the end of the new ChangeLog, in order to provide
+the appropriate settings when editing this file with emacs:
+@smallexample
+Local Variables:
+mode: change-log
+left-margin: 8
+fill-column: 74
+version-control: never
+End:
+@end smallexample
+
+@item
+Update the copyright year in the startup message
+
+Update the copyright year in file @file{top.c}, function
+@code{print_gdb_version}.
+@end itemize
+
 @node Releasing GDB
 
 @chapter Releasing @value{GDBN}