summaryrefslogtreecommitdiffstatshomepage
path: root/mdoc.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 /mdoc.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 'mdoc.7')
-rw-r--r--mdoc.716
1 files changed, 13 insertions, 3 deletions
diff --git a/mdoc.7 b/mdoc.7
index 23626653..35d1fb38 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -1,4 +1,4 @@
-.\" $Id: mdoc.7,v 1.28 2009/06/12 12:40:44 kristaps Exp $
+.\" $Id: mdoc.7,v 1.29 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 12 2009 $
+.Dd $Mdocdate: June 16 2009 $
.Dt MDOC 7
.Os
.\" SECTION
@@ -78,9 +78,19 @@ or
.Sq \&.Bd \-unfilled
contexts.
.\" 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 Reserved Characters
Within a macro line, the following characters are reserved:
-.Bl -tag -width 12n -offset XXXX -compact
+.Bl -tag -width Ds -offset XXXX -compact
.It \&.
.Pq period
.It \&,