=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.142 retrieving revision 1.145 diff -u -p -r1.142 -r1.145 --- mandoc/mandoc.1 2015/02/04 16:38:56 1.142 +++ mandoc/mandoc.1 2015/02/04 22:30:10 1.145 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.142 2015/02/04 16:38:56 schwarze Exp $ +.\" $Id: mandoc.1,v 1.145 2015/02/04 22:30:10 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons .\" Copyright (c) 2012, 2014, 2015 Ingo Schwarze @@ -994,7 +994,8 @@ except that it may control a following clause. .It Sy "skipping empty macro" .Pq mdoc -The indicated macro has no arguments and hence no effect. +The indicated macro has no arguments or no body content +and hence no effect. .It Sy "empty argument, using 0n" .Pq mdoc The required width is missing after @@ -1091,6 +1092,14 @@ macro has no argument, or only one argument and no mac on the same input line. This defeats its purpose; in particular, spacing is not suppressed before the text or macros following on the next input line. +.It Sy "empty reference block" +.Pq mdoc +An +.Ic \&Rs +macro is immediately followed by an +.Ic \&Re +macro on the next input line. +Such an empty block does not produce any output. .It Sy "missing -std argument, adding it" .Pq mdoc An @@ -1594,7 +1603,10 @@ An .Ic \&Ef , .Ic \&Ek , .Ic \&El , +.Ic \&Lp , +.Ic \&Pp , .Ic \&Re , +.Ic \&Rs , or .Ic \&Ud macro, an @@ -1612,17 +1624,29 @@ or .Ic \&EN macro, or a .Xr roff 7 +.Ic \&br +request or .Sq \&.. block closing request is invoked with at least one argument. All arguments are ignored. .It Sy "skipping excess arguments" .Pq mdoc , man , roff The -.Ic \&Bf -macro is invoked with more than one argument, the +.Ic \&An +macro is invoked with another argument after +.Fl split +or +.Fl nosplit , +.Ic \&Bd , +.Ic \&Bk , +or +.Ic \&Bl +are invoked with invalid arguments, the .Ic \&RE macro is invoked with more than one argument -or with a non-integer argument, or a request of the +or with a non-integer argument, the +.Ic \&sp +request is invoked with more than one argument, or a request of the .Ic \&de family is invoked with more than two arguments. The excess arguments are ignored.