=================================================================== RCS file: /cvs/mandoc/mdoc.7,v retrieving revision 1.94 retrieving revision 1.98 diff -u -p -r1.94 -r1.98 --- mandoc/mdoc.7 2010/04/13 05:26:49 1.94 +++ mandoc/mdoc.7 2010/05/08 22:26:39 1.98 @@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.94 2010/04/13 05:26:49 kristaps Exp $ +.\" $Id: mdoc.7,v 1.98 2010/05/08 22:26:39 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons .\" @@ -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: April 13 2010 $ +.Dd $Mdocdate: May 8 2010 $ .Dt MDOC 7 .Os .Sh NAME @@ -181,23 +181,14 @@ 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 +Whitespace consists of the space character. +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 whitespace, 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 @@ -1823,10 +1814,6 @@ are aliases, as are .Fl literal and .Fl unfilled . -.It -In mandoc, blocks of whitespace are stripped from both macro and -free-form text lines (except when in literal mode); groff would retain -whitespace in free-form text lines. .It Historic groff has many un-callable macros. Most of these (excluding some block-level macros) are now callable.