Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1jP7vV-00079t-Ud
	for pgsql-hackers@arkaria.postgresql.org; Thu, 16 Apr 2020 17:03:45 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1jP7vU-0004ZW-0o
	for pgsql-hackers@arkaria.postgresql.org; Thu, 16 Apr 2020 17:03:44 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1jP7vT-0004YD-Qe
	for pgsql-hackers@lists.postgresql.org; Thu, 16 Apr 2020 17:03:43 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1jP7vQ-0007yf-Nr
	for pgsql-hackers@lists.postgresql.org; Thu, 16 Apr 2020 17:03:42 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id 03GH3aEH027620;
	Thu, 16 Apr 2020 13:03:36 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Pierre Giraud <pierre.giraud@dalibo.com>
cc: pgsql-hackers@lists.postgresql.org
Subject: Re: Poll: are people okay with function/operator table redesign?
In-reply-to: <9991f78c-989e-9089-12ee-6b8d2904929f@dalibo.com>
References: <8691.1586798003@sss.pgh.pa.us>
 <ff4b8688-c941-8bfc-5399-4f0744144773@dalibo.com>
 <CAMsGm5dhAAf9YZh3scCcs_SX+2F2k1QyRPWn0hgnOX2xQOPo4Q@mail.gmail.com>
 <CAFj8pRB0CL4sNuskp8NQ0g4stiOfy_Rfau35LyncwNvciJarZw@mail.gmail.com>
 <CA+TgmobK4iziOm8uMJ4pS+W3VkB+OarEb+vXePxfAVMghynn6g@mail.gmail.com>
 <CAKmB1PHtM0rt9Ja5_W7osrWEQsoGbZ-morn9vpzQF8rSDXwp6Q@mail.gmail.com>
 <30753.1586971147@sss.pgh.pa.us> <29261.1586989134@sss.pgh.pa.us>
 <f1f6889d-8caf-b2ed-fab5-214ebcfa0a07@dalibo.com>
 <20662.1587048193@sss.pgh.pa.us>
 <9991f78c-989e-9089-12ee-6b8d2904929f@dalibo.com>
Comments: In-reply-to Pierre Giraud <pierre.giraud@dalibo.com>
	message dated "Thu, 16 Apr 2020 17:12:28 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <27618.1587056616.1@sss.pgh.pa.us>
Content-Transfer-Encoding: 8bit
Date: Thu, 16 Apr 2020 13:03:36 -0400
Message-ID: <27619.1587056616@sss.pgh.pa.us>
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Precedence: bulk

Pierre Giraud <pierre.giraud@dalibo.com> writes:
> Le 16/04/2020 à 16:43, Tom Lane a écrit :
>> Pierre Giraud <pierre.giraud@dalibo.com> writes:
>>> The screenshot attached uses a <dl> tag for the descrition/example block.

>> That looks about right, perhaps, but could you be a little clearer about
>> how you accomplished that?

> Attached you will find the HTML structure with associated styles.
> Sorry I haven't tried to do this from the DocBook sources.
> I hope this helps though.

After a bit of poking at it, I couldn't find another way to do that
than using a <variablelist> structure.  Which is an annoying amount
of markup to be adding to each table cell, but I guess we could live
with it.  A bigger problem is that docbook applies styles to the
<dl> structure that, at least by default, add a LOT of vertical space.
Doesn't seem real workable unless we can undo that.

			regards, tom lane