===================================================================
RCS file: /cvs/mandoc/man.7,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -p -r1.12 -r1.13
--- mandoc/man.7	2009/06/11 07:26:35	1.12
+++ mandoc/man.7	2009/06/16 19:13:28	1.13
@@ -1,4 +1,4 @@
-.\"	$Id: man.7,v 1.12 2009/06/11 07:26:35 kristaps Exp $
+.\"	$Id: man.7,v 1.13 2009/06/16 19:13:28 kristaps Exp $
 .\"
 .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: June 11 2009 $
+.Dd $Mdocdate: June 16 2009 $
 .Dt MAN 7
 .Os
 .\" SECTION
@@ -69,6 +69,16 @@ escape is common in historical
 .Nm
 documents; if encountered at the end of a word, it ensures that the
 subsequent word isn't off-set by whitespace.
+.\" SUB-SECTION
+.Ss Comments
+Anything following a
+.Sq \e" 
+delimiter is considered a comment (unless the 
+.Sq \e
+itself has been escaped) and is ignored to the end of line.
+Furthermore, a macro line with only a control character
+.Sq \. ,
+optionally followed by whitespace, is ignored.
 .\" SUB-SECTION
 .Ss Special Characters
 Special character sequences begin with the escape character