summaryrefslogtreecommitdiffstatshomepage
path: root/mdoc.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2010-05-08 08:36:44 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2010-05-08 08:36:44 +0000
commit24b4a7d475e7f3fa5f5aeb456984285e5938c35c (patch)
treeba527c515f84c5caa50cf65cfec8f131f687b8e7 /mdoc.7
parent29086c29fdd989b9c086bf25e0790ba21243c4ff (diff)
downloadmandoc-24b4a7d475e7f3fa5f5aeb456984285e5938c35c.tar.gz
mandoc-24b4a7d475e7f3fa5f5aeb456984285e5938c35c.tar.zst
mandoc-24b4a7d475e7f3fa5f5aeb456984285e5938c35c.zip
Strip trailing, unescaped whitespace from free-form, non-literal lines (like groff).
Diffstat (limited to 'mdoc.7')
-rw-r--r--mdoc.722
1 files changed, 6 insertions, 16 deletions
diff --git a/mdoc.7 b/mdoc.7
index e2eaa5e2..dc60ad83 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -1,4 +1,4 @@
-.\" $Id: mdoc.7,v 1.95 2010/05/07 15:49:36 kristaps Exp $
+.\" $Id: mdoc.7,v 1.96 2010/05/08 08:36:44 kristaps Exp $
.\"
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@bsd.lv>
.\"
@@ -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: May 7 2010 $
+.Dd $Mdocdate: May 8 2010 $
.Dt MDOC 7
.Os
.Sh NAME
@@ -181,23 +181,13 @@ and
.Sq \e*(Ba
.Pq vertical bar .
.Ss Whitespace
-In non-literal free-form lines, consecutive blocks of whitespace are
-pruned from input and added later in the output filter, if applicable:
-.Bd -literal -offset indent
-These spaces are pruned from input.
-\&.Bd \-literal
-These are not.
-\&.Ed
-.Ed
+In free-form lines, whitespace is preserved within a line; un-escaped
+trailing spaces are stripped from input (unless in a literal context).
+Blank free-form lines, which may include spaces, are only permitted
+within literal contexts.
.Pp
In macro lines, whitespace delimits arguments and is discarded. If
arguments are quoted, whitespace within the quotes is retained.
-.Pp
-Blank lines are only permitted within literal contexts, as are lines
-containing only whitespace. Tab characters are only acceptable when
-delimiting
-.Sq \&Bl \-column
-or when in a literal context.
.Ss Quotation
Macro arguments may be quoted with a double-quote to group
space-delimited terms or to retain blocks of whitespace. A quoted