=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.195 retrieving revision 1.198 diff -u -p -r1.195 -r1.198 --- mandoc/mandoc.1 2017/06/07 23:29:48 1.195 +++ mandoc/mandoc.1 2017/06/11 17:16:51 1.198 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.195 2017/06/07 23:29:48 schwarze Exp $ +.\" $Id: mandoc.1,v 1.198 2017/06/11 17:16:51 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons .\" Copyright (c) 2012, 2014-2017 Ingo Schwarze @@ -15,7 +15,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 7 2017 $ +.Dd $Mdocdate: June 11 2017 $ .Dt MANDOC 1 .Os .Sh NAME @@ -798,6 +798,20 @@ number. Do not use punctuation at the end of an .Ic \&Nd block. +.It Sy "no blank before trailing delimiter" +.Pq mdoc +The last argument of a macro that supports trailing delimiter +arguments is longer than one byte and ends with a trailing delimiter. +Consider inserting a blank such that the delimiter becomes a separate +argument, thus moving it out of the scope of the macro. +.It Sy "function name without markup" +.Pq mdoc +A word followed by an empty pair of parentheses occurs on a text line. +Consider using an +.Ic \&Fn +or +.Ic \&Xr +macro. .El .Ss Warnings related to the document prologue .Bl -ohang @@ -1399,6 +1413,12 @@ or .Ic \&Fn macro contains an opening or closing parenthesis; that's probably wrong, parentheses are added automatically. +.It Sy "unknown library name" +.Pq mdoc, not on Ox +An +.Ic \&Lb +macro has an unknown name argument and will be rendered as +.Qq library Dq Ar name . .It Sy "invalid content in Rs block" .Pq mdoc An