From 294cf32a27d430922b8f008f10b766ddce477cf6 Mon Sep 17 00:00:00 2001 From: Ingo Schwarze Date: Thu, 29 Jun 2017 15:22:17 +0000 Subject: warn about some non-portable idioms in .Bl -column; triggered by a question from Yuri Pankov (illumos) --- mandoc.1 | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) (limited to 'mandoc.1') diff --git a/mandoc.1 b/mandoc.1 index 7ac89ed9..5d59ba4f 100644 --- a/mandoc.1 +++ b/mandoc.1 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.208 2017/06/27 12:18:00 schwarze Exp $ +.\" $Id: mandoc.1,v 1.209 2017/06/29 15:22:17 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 27 2017 $ +.Dd $Mdocdate: June 29 2017 $ .Dt MANDOC 1 .Os .Sh NAME @@ -1218,6 +1218,12 @@ list block contains text or macros before the first .Ic \&It macro. The offending children are moved before the beginning of the list. +.It Sy "first macro on line" +Inside a +.Ic \&Bl Fl column +list, a +.Ic \&Ta +macro occurs as the first macro on a line, which is not portable. .It Sy "fill mode already enabled, skipping" .Pq man A @@ -1363,6 +1369,17 @@ list, an .Ic \&It block is empty. An empty list item is shown. +.It Sy "missing argument, using next line" +.Pq mdoc +An +.Ic \&It +macro in a +.Ic \&Bd Fl column +list has no arguments. +While +.Nm +uses the text or macros of the following line, if any, for the cell, +other formatters may misformat the list. .It Sy "missing font type, using \efR" .Pq mdoc A -- cgit v1.2.3