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 1jP6C2-0002kk-6Z
	for pgsql-hackers@arkaria.postgresql.org; Thu, 16 Apr 2020 15:12:42 +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 1jP6C0-00059s-RR
	for pgsql-hackers@arkaria.postgresql.org; Thu, 16 Apr 2020 15:12:40 +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 <pierre.giraud@dalibo.com>)
	id 1jP6C0-00059l-98
	for pgsql-hackers@lists.postgresql.org; Thu, 16 Apr 2020 15:12:40 +0000
Received: from mail.dalibo.com ([212.85.157.172])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pierre.giraud@dalibo.com>)
	id 1jP6Bs-00075Q-SR
	for pgsql-hackers@lists.postgresql.org; Thu, 16 Apr 2020 15:12:38 +0000
Received: from [192.168.0.10] (91-165-40-181.subs.proxad.net [91.165.40.181])
	by mail.dalibo.com (Postfix) with ESMTPSA id 1449520532
	for <pgsql-hackers@lists.postgresql.org>;
 Thu, 16 Apr 2020 17:12:29 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=dalibo.com; s=a;
	t=1587049949; bh=SMdEVvqHzJhzmxfFe3sIZoPS7gBlzG3C+vdFq95Mcww=;
	h=Subject:To:References:From:Date:In-Reply-To:From;
	b=jB4+SV9+xML1FJfVj1dEi+GBbeDDyILUSrQMQHjX+AgFb+tk9yy7XmZHdTWlNpG5N
	 5iUwwEqRbaniz0fFjjx7I8gkltAr9sjbL19XF84+/QkOqwGEe/KdXa0dXbdVLe2Fjv
	 IsT24LWA9cEIXyrbN63DEUWUhEh3FPXjW339Eb3Q=
Subject: Re: Poll: are people okay with function/operator table redesign?
To: pgsql-hackers@lists.postgresql.org
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>
From: Pierre Giraud <pierre.giraud@dalibo.com>
Message-ID: <9991f78c-989e-9089-12ee-6b8d2904929f@dalibo.com>
Date: Thu, 16 Apr 2020 17:12:28 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.4.1
MIME-Version: 1.0
In-Reply-To: <20662.1587048193@sss.pgh.pa.us>
Content-Type: multipart/mixed;
 boundary="------------DC9F85A25B70B8165D15AD22"
Content-Language: en-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

This is a multi-part message in MIME format.
--------------DC9F85A25B70B8165D15AD22
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit



Le 16/04/2020 à 16:43, Tom Lane a écrit :
> Pierre Giraud <pierre.giraud@dalibo.com> writes:
>> Le 16/04/2020 à 00:18, Tom Lane a écrit :
>>> The main disadvantage I can see to the v2 design is that we're back
>>> to having two <rows> per function, which is inevitably going to result
>>> in PDF builds putting page breaks between those rows.  But you can't
>>> have everything ... and maybe we could find a way to discourage such
>>> breaks if we tried.
> 
> Further experimentation shows that the PDF toolchain is perfectly willing
> to put a page break *within* a multi-line <row>; if there is any
> preference to break between rows instead, it's pretty weak.  So that
> argument is a red herring and we shouldn't waste time chasing it.
> However, there'd still be some advantage in not being dependent on CSS
> hackery to make it look nice in HTML.
> 
> What we're down to wanting, at this point, is basically a para with
> hanging indent.
> 
>> What about putting everything into one <table row> and use a block with
>> some left padding/margin for description + example.
>> This would solve the PDF page break issue as well as the column
>> separation border one.
>> 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.

Regards

--------------DC9F85A25B70B8165D15AD22
Content-Type: text/plain; charset=UTF-8;
 name="table_html_structure_with_dl.txt"
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
 filename="table_html_structure_with_dl.txt"

IyBIVE1MCgogICAgICA8dGFibGUgY2xhc3M9InRhYmxlIiBzdW1tYXJ5PSJEYXRlL1RpbWUg
RnVuY3Rpb25zIiBib3JkZXI9IjEiPgogICAgICAgIDx0aGVhZD4KICAgICAgICAgIDx0cj4K
ICAgICAgICAgICAgPHRoIGFsaWduPSIiIHZhbGlnbj0ibWlkZGxlIj4KICAgICAgICAgICAg
ICBGdW5jdGlvbgogICAgICAgICAgICAgIDxkbD4KICAgICAgICAgICAgICAgIDxkZD5EZXNj
cmlwdGlvbjwvZGQ+IAogICAgICAgICAgICAgICAgPGRkPkV4YW1wbGU8L2RkPgogICAgICAg
ICAgICAgIDwvZGw+CiAgICAgICAgICAgIDwvdGg+CiAgICAgICAgICA8L3RyPgogICAgICAg
IDwvdGhlYWQ+CiAgICAgICAgPHRib2R5PgogICAgICAgICAgPHRyPgogICAgICAgICAgICA8
dGQ+CiAgICAgICAgICAgICAgPGNvZGUgY2xhc3M9ImZ1bmN0aW9uIj5hZ2U8L2NvZGU+KDxj
b2RlIGNsYXNzPSJ0eXBlIj50aW1lc3RhbXA8L2NvZGU+LCA8Y29kZSBjbGFzcz0idHlwZSI+
dGltZXN0YW1wPC9jb2RlPikg4oaSIDxjb2RlIGNsYXNzPSJyZXR1cm52YWx1ZSI+aW50ZXJ2
YWw8L2NvZGU+CiAgICAgICAgICAgICAgPGRsPgogICAgICAgICAgICAgICAgPGRkPlN1YnRy
YWN0IGFyZ3VtZW50cywgcHJvZHVjaW5nIGEgPHNwYW4gY2xhc3M9InF1b3RlIj7igJw8c3Bh
biBjbGFzcz0icXVvdGUiPnN5bWJvbGljPC9zcGFuPuKAnTwvc3Bhbj4gcmVzdWx0IHRoYXQg
dXNlcyB5ZWFycyBhbmQgbW9udGhzLCByYXRoZXIgdGhhbiBqdXN0IGRheXMKICAgICAgICAg
ICAgICAgIDwvZGQ+CiAgICAgICAgICAgICAgICA8ZGQ+CiAgICAgICAgICAgICAgICA8c3Bh
bj4KICAgICAgICAgICAgICAgICAgPGNvZGUgY2xhc3M9ImxpdGVyYWwiPmFnZSh0aW1lc3Rh
bXAgJzIwMDEtMDQtMTAnLCB0aW1lc3RhbXAgJzE5NTctMDYtMTMnKTwvY29kZT4g4oaSIDxj
b2RlIGNsYXNzPSJsaXRlcmFsIj40MyB5ZWFycyA5IG1vbnMgMjcgZGF5czwvY29kZT4KICAg
ICAgICAgICAgICAgIDwvc3Bhbj4KICAgICAgICAgICAgICAgIDwvZGQ+CiAgICAgICAgICAg
ICAgPC9kbD4KICAgICAgICAgICAgPC90ZD4KICAgICAgICAgIDwvdHI+CiAgICAgICAgPC90
Ym9keT4KICAgICAgPC90YWJsZT4KCiMgQ1NTCgojZG9jQ29udGVudCB0YWJsZS50YWJsZSBj
b2RlLmxpdGVyYWwgewogICAgZm9udC1zdHlsZTogaXRhbGljOwp9Cgpjb2RlLnJldHVybnZh
bHVlIHsKICAgIGZvbnQtd2VpZ2h0OiBib2xkOwp9Cgpjb2RlLmZ1bmN0aW9uIHsKICAgIGZv
bnQtd2VpZ2h0OiBib2xkOwp9CgoucmVwbGFjZWFibGUgPiBjb2RlIHsKICAgIGZvbnQtd2Vp
Z2h0OiBub3JtYWwgIWltcG9ydGFudDsKfQoKI2RvY0NvbnRlbnQgdGFibGUudGFibGUgZGwg
ewogICAgbWFyZ2luLWxlZnQ6IDMwcHg7CiAgICBtYXJnaW4tdG9wOiA1cHg7Cn0KCiNkb2ND
b250ZW50IHRhYmxlLnRhYmxlIGRsID4gZGQgewogICAgbWFyZ2luLWJvdHRvbTogMDsKfQo=
--------------DC9F85A25B70B8165D15AD22--