From: Neil Puttock <n.puttock@gmail.com>
Date: Tue, 26 Jan 2010 00:29:23 +0000 (+0000)
Subject: Doc: CG: Add `grand-replace' instructions.
X-Git-Tag: release/2.13.12-1~46
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=ff666bcb555adc8856dd458809a399fdcaaf4cdc;p=lilypond.git

Doc: CG: Add `grand-replace' instructions.
---

diff --git a/Documentation/contributor/release-work.itexi b/Documentation/contributor/release-work.itexi
index a074a6f14d..74dccb2b47 100644
--- a/Documentation/contributor/release-work.itexi
+++ b/Documentation/contributor/release-work.itexi
@@ -406,5 +406,20 @@ probably be the one taking care of this anyway.
 A translator can ask for an official lilypond-xy mailing list once
 they've finished all @qq{priority 1} translation items.
 
+@subsubheading Performing yearly copyright update (@qq{grand-replace})
 
+At the start of each year, copyright notices for all source files
+should be refreshed by running the following command from the top of
+the source tree:
 
+@example
+make grand-replace
+@end example
+
+Internally, this invokes the script @file{scripts/build/grand-replace.py},
+which performs a regular expression substitution for old-year -> new-year
+wherever it finds a valid copyright notice.
+
+Note that snapshots of third party files such as @file{texinfo.tex} should
+not be included in the automatic update; @file{grand-replace.py} ignores these
+files if they are listed in the variable @code{copied_files}.