Doc: Issue 3807: More accurate wording for \version instructions

diff --git a/Documentation/contributor/doc-work.itexi b/Documentation/contributor/doc-work.itexi
index c6d8560c0be772d28d1b4a24e5bc74dff63a362c..55c51bddaf008f8ee63564f986188786b9f02ac9 100644 (file)
--- a/Documentation/contributor/doc-work.itexi
+++ b/Documentation/contributor/doc-work.itexi
@@ -70,15 +70,17 @@ encouraged to contact the @ref{Meisters, Documentation Meister}.
 @node version in documentation files
 @section @code{\version} in documentation files
 
-Every documentation file which includes LilyPond code should begin
-with a @code{\version} statement referencing a version of LilyPond
+Every documentation file which includes LilyPond code must begin
+with a @code{\version} statement, since the build procedure
+explicitly tests for its presence and will not continue otherwise.
+The @code{\version} statement should reference a version of LilyPond
 consistent with the syntax of the contained code.
 
-The @code{\version} statement should be commented out to avoid
-creating problems when building releases with GUB, like this:
+Since the @code{\version} statement is not valid Texinfo input it
+must be commented out like this:
 
 @example
-%c \version "2.19.1"
+@@c \version "2.19.1"
 @end example
 
 So, if you are adding LilyPond code which is not consistent with the