From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mail-pd0-f177.google.com (mail-pd0-f177.google.com [209.85.192.177])
	by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id r8MMXVmm022448
	for <discuss@mdocml.bsd.lv>; Sun, 22 Sep 2013 18:33:32 -0400 (EDT)
Received: by mail-pd0-f177.google.com with SMTP id y10so2458443pdj.8
        for <discuss@mdocml.bsd.lv>; Sun, 22 Sep 2013 15:33:26 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20130820;
        h=x-gm-message-state:from:to:subject:date:message-id;
        bh=bpXTjOmT6l6AuXiaiP7NNQXGGfcaKNOWwwMeTuidlV4=;
        b=VSLvJhqG1705Z0FtL2E29+lmPlnWe9utOEpgYR87jiO8V46zk95w86nXRg2cS/Vo5r
         XobHyH3r8mB+mhs41Fo5eS57Gqo6bX2tOB2YORGL/GmWQcHgu8EQL8elGOOQJlOMauC9
         dtMf61J60o8eRFBssV/sNkEHkveooBtVc8rws9TKQMNPG40jySzmsEucPT66pJqReEEf
         5Ohb0uSsFI4QKPrIYwFW+LPzqyg5Bs1EzOKvseM1qPhVmukEX7M1nwVpSFVTfvh3uOOa
         3/mQIYMfzbQrhCxC15CSogPZoOuelMr3mR0VcURmosXcICBm2JUW3L5Ze+VzRxcUOVsB
         5CeA==
X-Gm-Message-State: ALoCoQm3wwePsaow40ynV20/oOMG3XCouHmC/ZIsK21y1DW3haIU16uacNe7kwoqyhAqFslEGYtN
X-Received: by 10.68.136.7 with SMTP id pw7mr20461711pbb.106.1379889203843;
        Sun, 22 Sep 2013 15:33:23 -0700 (PDT)
Received: from cathet.us (c-76-18-88-142.hsd1.nm.comcast.net. [76.18.88.142])
        by mx.google.com with ESMTPSA id ar1sm29861258pbc.34.1969.12.31.16.00.00
        (version=TLSv1.2 cipher=AES128-SHA bits=128/128);
        Sun, 22 Sep 2013 15:33:23 -0700 (PDT)
Received: from cathet.us (localhost [127.0.0.1]);
	by cathet.us (OpenSMTPD) with ESMTP id 80dd433a;
	for <discuss@mdocml.bsd.lv>;
	Sun, 22 Sep 2013 16:33:21 -0600 (MDT)
From: "Anthony J. Bentley" <anthony@cathet.us>
To: discuss@mdocml.bsd.lv
Subject: Text embedded in Bl
Date: Sun, 22 Sep 2013 16:33:21 -0600
Message-ID: <1490.1379889201@cathet.us>
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv

Hi,

Consider the following, based on an example from gnugk(1):

.Bl -tag -width Ds
This is an opening paragraph.
.It Fl a
Perform behavior foo.
...
.El

Mandoc refuses to display the page:
FATAL: child violates parent syntax

Groff, on the other hand, displays it (I'm not sure of the specifics, but
my guess is it treats the first part as a Pp):

     This is an opening paragraph.

     -a      Perform behavior foo.

To me, this is obviously wrong. To realize why, just think of the case
where you want two paragraphs. (Or the case where the Bl only contains a
single paragraph with no items--which also appeared in this manpage!)
Based on this reasoning, I sent a fixed manpage to upstream, who committed
it.

But now I wonder. Should mandoc mimic groff here? I think no, but maybe
someone else will have a different opinion.

-- 
Anthony J. Bentley
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv