diff options
author | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-06-16 19:13:28 +0000 |
---|---|---|
committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-06-16 19:13:28 +0000 |
commit | 632038c8c98f1c408bb368edf910b849f186dc8a (patch) | |
tree | 000479224756a6b4a7749394e9208b7308c220ab /mdoc.7 | |
parent | b06a75d0798f3ff62d04b3ade52cf34a4ff94613 (diff) | |
download | mandoc-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.7 | 16 |
1 files changed, 13 insertions, 3 deletions
@@ -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 \&, |