From owner-freebsd-doc@FreeBSD.ORG  Sun Mar 17 17:26:29 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by hub.freebsd.org (Postfix) with ESMTP id F29F8EAB;
 Sun, 17 Mar 2013 17:26:28 +0000 (UTC) (envelope-from des@des.no)
Received: from smtp.des.no (smtp.des.no [194.63.250.102])
 by mx1.freebsd.org (Postfix) with ESMTP id A617FA82;
 Sun, 17 Mar 2013 17:26:28 +0000 (UTC)
Received: from ds4.des.no (smtp.des.no [194.63.250.102])
 by smtp-int.des.no (Postfix) with ESMTP id 431C0BDF5;
 Sun, 17 Mar 2013 17:26:21 +0000 (UTC)
Received: by ds4.des.no (Postfix, from userid 1001)
 id E774D9AA3; Sun, 17 Mar 2013 18:26:20 +0100 (CET)
From: =?utf-8?Q?Dag-Erling_Sm=C3=B8rgrav?= <des@des.no>
To: doc@freebsd.org
Subject: Tagged lists with multiple tags in mdoc
Date: Sun, 17 Mar 2013 18:26:20 +0100
Message-ID: <868v5mkkeb.fsf@ds4.des.no>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Cc: ru@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 17 Mar 2013 17:26:29 -0000

I need to make a tagged list where some items have multiple tags - for
instance,

    function1()
    function2()
    function3()
            These are the first three functions.

    function4()
            This is the fourth function.

If I use

.Bl -tag
.It Fn function1
.It Fn function2
.It Fn function3
These are the first three functions.
.It Fn function4
This is the fourth function.
.El

groff will insert blank lines after function1() and function2(), which
I'd like to avoid.  Conversely, if I use -compact, it will omit the
blank lines between before function4() and between the list and the
surrounding text, which is also wrong.

I also tried

.It Fn function1 , Fn function2 , Fn function3

but this is far less readable, and if there are enough items to cause
groff to wrap, the second line will be indented:

    function1(), function2(), function3(), function4(), function5(),
            function6(), function7(), function8()
            These are the first eight functions.

Is there a non-hackish (or not-too-hackish) way to achieve the desired
result?

DES
--=20
Dag-Erling Sm=C3=B8rgrav - des@des.no