From: | "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, Robert Haas <robertmhaas(at)gmail(dot)com>, Steven Pousty <steve(dot)pousty(at)gmail(dot)com>, Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com>, Isaac Morland <isaac(dot)morland(at)gmail(dot)com>, Pierre Giraud <pierre(dot)giraud(at)dalibo(dot)com>, PostgreSQL Developers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
Subject: | Re: Poll: are people okay with function/operator table redesign? |
Date: | 2020-05-05 02:18:03 |
Message-ID: | 7d7d8a89-20ed-9a3b-0f74-b2e73daa4173@postgresql.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On 5/4/20 6:39 PM, Tom Lane wrote:
> "Jonathan S. Katz" <jkatz(at)postgresql(dot)org> writes:
>> On 5/4/20 5:22 PM, Tom Lane wrote:
>> It does look better, but things look a bit smushed together on the pgweb
>> front.
>
> Yeah. There's less smushing of function signatures when building the
> docs without STYLE=website, so there's something specific to the
> website style. I think you'd mentioned that we were intentionally
> crimping the space and/or font size within tables? Maybe that could
> get un-done now. I hadn't bothered to worry about such details until
> we had a reasonable sample of cases to look at, but now would be a
> good time.
IIRC this was the monospace issue[1], but there are some other things
I'm seeing (e.g. the italics) that may be pushing things closer together
htan not. Now that round 1 of commits are in, I can take a whack at
tightening it up this week.
> Another rendering oddity that I'd not bothered to chase down is
> the appearance of <itemizedlist> environments within table cells.
> We have a few of those now as a result of migration of material
> that had been out-of-line into the table cells; one example is
> in json_populate_record, about halfway down this page:
>
> https://www.postgresql.org/docs/devel/functions-json.html
>
> The text of the list items seems to be getting indented to the
> same extent as a not-in-a-table <itemizedlist> list does ---
> but the bullets aren't indented nearly as much, making for
> weird spacing. (There's a short <itemizedlist> at the top of
> the same page that you can compare to.)
Looking at the code, I believe this is a pretty straightforward
adjustment. I can include it with the aforementioned changes.
Jonathan
[1]
https://www.postgresql.org/message-id/3f8560a6-9044-bdb8-6b3b-68842570db18@postgresql.org
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2020-05-05 03:16:00 | PG 13 release notes, first draft |
Previous Message | Jonathan S. Katz | 2020-05-05 02:12:15 | Re: Another modest proposal for docs formatting: catalog descriptions |