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 1jTw9R-0004P4-9h
	for pgsql-hackers@arkaria.postgresql.org; Wed, 29 Apr 2020 23:30:01 +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 1jTw9O-0006HV-3j
	for pgsql-hackers@arkaria.postgresql.org; Wed, 29 Apr 2020 23:29:58 +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 1jTw9N-0006Bw-Qg
	for pgsql-hackers@lists.postgresql.org; Wed, 29 Apr 2020 23:29:57 +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 1jTw9G-0006ch-EE
	for pgsql-hackers@lists.postgresql.org; Wed, 29 Apr 2020 23:29:55 +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 03TNThXe008683;
	Wed, 29 Apr 2020 19:29:43 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
cc: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>,
        Bruce Momjian <bruce@momjian.us>,
        Alvaro Herrera <alvherre@2ndquadrant.com>,
        Robert Haas <robertmhaas@gmail.com>,
        Steven Pousty <steve.pousty@gmail.com>,
        Pavel Stehule <pavel.stehule@gmail.com>,
        Isaac Morland <isaac.morland@gmail.com>,
        Pierre Giraud <pierre.giraud@dalibo.com>,
        PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
Subject: Re: Poll: are people okay with function/operator table redesign?
In-reply-to: <30469.1588087170@sss.pgh.pa.us>
References: <20200423174343.GA16996@alvherre.pgsql>
 <19233.1587665407@sss.pgh.pa.us> <5561.1587922854@sss.pgh.pa.us>
 <13e5e408-bc59-e8ca-44f3-28a981b4fc7d@postgresql.org>
 <a47ea348-b9a0-02b7-5bcb-7a32143dd16f@postgresql.org>
 <11211.1587951842@sss.pgh.pa.us>
 <58de9544-be5b-f325-b5cc-cce4e2dda7d9@postgresql.org>
 <5651.1587991781@sss.pgh.pa.us>
 <b998a672-2525-1cba-ac64-b292f495919e@postgresql.org>
 <30469.1588087170@sss.pgh.pa.us>
Comments: In-reply-to Tom Lane <tgl@sss.pgh.pa.us>
	message dated "Tue, 28 Apr 2020 11:19:30 -0400"
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="----- =_aaaaaaaaaa0"
Content-ID: <8634.1588202918.0@sss.pgh.pa.us>
Date: Wed, 29 Apr 2020 19:29:43 -0400
Message-ID: <8682.1588202983@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

------- =_aaaaaaaaaa0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <8634.1588202918.1@sss.pgh.pa.us>

After further fooling with this issue, I've determined that

(1) I need to be able to use <programlisting> environments within the
func_table_entry cells and have them render more-or-less normally.
There doesn't seem to be any other good way to render multiline
example results for set-returning functions ... but marking such
environments up to the extent that the website style normally does
is very distracting.

(2) I found that adding !important to the func_table_entry rules
is enough to override less-general !important rules.  So it'd be
possible to leave all the existing CSS rules alone, if that makes
you feel more comfortable.

The attached updated patch reflects both of these conclusions.
We could take out some of the !important annotations here if
you're willing to delete !important annotations in more-global
rules for <p> and/or <pre>, but maybe that's something to fool
with later.  I'd like to get this done sooner ...

			regards, tom lane


------- =_aaaaaaaaaa0
Content-Type: text/x-diff; name="website-style-2.patch"; charset="us-ascii"
Content-ID: <8634.1588202918.2@sss.pgh.pa.us>
Content-Description: website-style-2.patch

--- main.css.orig	2020-04-29 17:19:24.089511785 -0400
+++ main.css	2020-04-29 19:18:28.082138095 -0400
@@ -799,6 +799,27 @@
 	text-align: left;
 }
 
+#docContent table.table th.func_table_entry p,
+#docContent table.table td.func_table_entry p {
+	margin-top: 0.1em;
+	margin-bottom: 0.1em !important;
+	padding-left: 4em;
+	text-align: left;
+}
+
+#docContent table.table p.func_signature {
+	text-indent: -3.5em;
+}
+
+#docContent table.table td.func_table_entry pre.programlisting {
+	margin-top: 0.1em !important;
+	margin-bottom: 0.1em !important;
+	padding: 0 !important;
+	padding-left: 4em !important;
+	background-color: inherit !important;
+	border: 0;
+}
+
 /**
  * Titles, Navigation
  */

------- =_aaaaaaaaaa0--