debian/control files may contain comment lines

Document the debian/control comment syntax of lines starting with #,
including their behavior with multiline fields.  Based on wording by
Julien Cristau <jcristau@debian.org>.

Closes #446712.

diff --git a/policy.sgml b/policy.sgml
index 8bb8b3f4f6964733992625ca5ed8ac0bf9ff49cb..58ba938faf40f1366153a48ebe15b5be5c2fcb6b 100644 (file)
--- a/policy.sgml
+++ b/policy.sgml
@@ -2450,6 +2450,14 @@ Package: libc6
          See <ref id="substvars"> for details.
        </p>
 
+       <p>
+         In addition to the control file syntax described <qref
+         id="controlsyntax">above</qref>, this file may also contain
+         comment lines starting with <tt>#</tt>.  All such lines are
+         ignored, even in the middle of continuation lines for a
+         multiline field, and do not end a multiline field.
+       </p>
+
       </sect>
 
       <sect id="binarycontrolfiles">