aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/man.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-06-16 19:13:28 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-06-16 19:13:28 +0000
commit632038c8c98f1c408bb368edf910b849f186dc8a (patch)
tree000479224756a6b4a7749394e9208b7308c220ab /man.7
parentb06a75d0798f3ff62d04b3ade52cf34a4ff94613 (diff)
downloadmandoc-632038c8c98f1c408bb368edf910b849f186dc8a.tar.gz
mandoc-632038c8c98f1c408bb368edf910b849f186dc8a.tar.zst
mandoc-632038c8c98f1c408bb368edf910b849f186dc8a.zip
Modernised comment handling: text following \" is thrown away before
either parser is invoked. Single-dot lines correctly handled. This confirms with both new- and old-groff. "Comment" subsection added to mdoc.7 and man.7.
Diffstat (limited to 'man.7')
-rw-r--r--man.714
1 files changed, 12 insertions, 2 deletions
diff --git a/man.7 b/man.7
index e9dd35d9..fa473867 100644
--- a/man.7
+++ b/man.7
@@ -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
@@ -70,6 +70,16 @@ escape is common in historical
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
.Sq \e