Re: Getting our tables to render better in PDF output

2020-02-11 Thread Alexander Lakhin
Hello Tom, 12.02.2020 00:51, Tom Lane wrote: > The crummy formatting of our tables of functions and operators has > been an issue for a long time. To my mind, there are several things > that need to be addressed: > > * The layout is completely unfriendly to function descriptions that > run to more

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Jonathan S. Katz
On 2/11/20 3:49 PM, Jonathan S. Katz wrote: > On 2/11/20 3:41 PM, Peter Geoghegan wrote: >> On Tue, Feb 11, 2020 at 11:40 AM Jonathan S. Katz >> wrote: >>> Anyway, attached is a first attempt at a patch. I tried a few different >>> variations but in my quick review of it, I could not figure out h

Getting our tables to render better in PDF output

2020-02-11 Thread Tom Lane
The crummy formatting of our tables of functions and operators has been an issue for a long time. To my mind, there are several things that need to be addressed: * The layout is completely unfriendly to function descriptions that run to more than a few words. * It's not very practical to have mo

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Jonathan S. Katz
On 2/11/20 3:41 PM, Peter Geoghegan wrote: > On Tue, Feb 11, 2020 at 11:40 AM Jonathan S. Katz > wrote: >> Anyway, attached is a first attempt at a patch. I tried a few different >> variations but in my quick review of it, I could not figure out how to >> make a XSLT respect having multiple style

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Peter Geoghegan
On Tue, Feb 11, 2020 at 11:40 AM Jonathan S. Katz wrote: > Anyway, attached is a first attempt at a patch. I tried a few different > variations but in my quick review of it, I could not figure out how to > make a XSLT respect having multiple stylesheets (likely due to my lack > of familiarity with

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Jonathan S. Katz
On 2/11/20 2:32 PM, Tom Lane wrote: > "Jonathan S. Katz" writes: >> On 2/11/20 1:37 PM, Tom Lane wrote: >>> I also wonder why duplicating the website's style isn't the default. >>> Doesn't seem like having authors optimize for some other style is >>> what we really want. > >> Oh, and specifically

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Peter Geoghegan
On Tue, Feb 11, 2020 at 10:37 AM Tom Lane wrote: > I also wonder why duplicating the website's style isn't the default. > Doesn't seem like having authors optimize for some other style is > what we really want. FWIW, I've often wondered about it myself. -- Peter Geoghegan

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Tom Lane
"Jonathan S. Katz" writes: > On 2/11/20 1:37 PM, Tom Lane wrote: >> I also wonder why duplicating the website's style isn't the default. >> Doesn't seem like having authors optimize for some other style is >> what we really want. > Oh, and specifically for this, my guess is because it requires on

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Jonathan S. Katz
On 2/11/20 1:37 PM, Tom Lane wrote: > I also wonder why duplicating the website's style isn't the default. > Doesn't seem like having authors optimize for some other style is > what we really want. Oh, and specifically for this, my guess is because it requires one to make a call over a network to

Re: Duplicating website's formatting in local doc builds

2020-02-11 Thread Jonathan S. Katz
On 2/11/20 1:37 PM, Tom Lane wrote: > I'm wondering how to do $SUBJECT. The fine manual suggests > > make STYLE=website html > > but what I'm getting here with that is not a very close approximation > of what I see at postgresql.org. It's closer than the default, > but it's not the same f

Duplicating website's formatting in local doc builds

2020-02-11 Thread Tom Lane
I'm wondering how to do $SUBJECT. The fine manual suggests make STYLE=website html but what I'm getting here with that is not a very close approximation of what I see at postgresql.org. It's closer than the default, but it's not the same font, margins, etc. I also wonder why duplicatin