Re: pgsql: Doc: Explain about Column List feature.

From: Peter Smith <smithpb2250(at)gmail(dot)com>
To: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
Cc: Amit Kapila <akapila(at)postgresql(dot)org>, pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: Re: pgsql: Doc: Explain about Column List feature.
Date: 2022-12-21 09:04:39
Message-ID: CAHut+Pu+PqR98QokeUoOL=0KacHXYtxVxG3R74jxpoYb1SHPUg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

On Wed, Dec 21, 2022 at 6:59 PM Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> wrote:
>
> On 2022-Dec-21, Peter Smith wrote:
>
> > By "searching" I also meant just scanning visually, although I was
> > thinking more about scanning the PDF.
> >
> > Right now, the intention of any text box is obvious at a glance
> > because of those titles like "Caution", "Tip", "Note", "Warning".
> > Sure, the HTML rendering also uses colours to convey the purpose, but
> > in the PDF version [1] everything is black-and-white so apart from the
> > title all boxes look the same. That's why I felt using non-standard
> > box titles might be throwing away some of the meaning - e.g. the
> > reader of the PDF won't know anymore at a glance are they looking at a
> > warning or a tip.
>
> Oh, I see. It's been so long that I haven't looked at the PDFs, that I
> failed to realize that they don't use color. I agree that would be a
> problem. Maybe we can change the title to have the word:
>
> <title>Warning: Combining Column Lists from Multiple Publications</title>
>

That last idea LGTM. But no patch at all LGTM also.

------
Kind Regards,
Peter Smith.
Fujitsu Australia.

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message David Rowley 2022-12-21 20:58:46 pgsql: Fix newly introduced bug in slab.c
Previous Message Alvaro Herrera 2022-12-21 07:59:08 Re: pgsql: Doc: Explain about Column List feature.

Browse pgsql-hackers by date

  From Date Subject
Next Message Drouvot, Bertrand 2022-12-21 09:06:42 Re: Minimal logical decoding on standbys
Previous Message Amit Kapila 2022-12-21 08:54:07 Re: Force streaming every change in logical decoding