| From: | Daniel Gustafsson <daniel(at)yesql(dot)se> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Robert Haas <robertmhaas(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>, Nathan Bossart <nathandbossart(at)gmail(dot)com> |
| Subject: | Re: --sync-method isn't documented to take an argument |
| Date: | 2023-10-04 14:56:54 |
| Message-ID: | 8CF2C172-4500-4A77-95DF-900F363D7196@yesql.se |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
> On 4 Oct 2023, at 16:51, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Daniel Gustafsson <daniel(at)yesql(dot)se> writes:
>> On 4 Oct 2023, at 16:39, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>>> I concluded a long time ago that it does nothing.
>
>> It does nothing in our current doc rendering, but if someone would like to
>> render docs with another style where it does make a difference it seems
>> unhelpful to not be consistent.
>
> To do that, we'd need some sort of agreement on what the possible
> "class" values are and when to use each one. I've never seen any
> documentation about that.
Thats fair. The 4.5 docbook guide isn't terribly helpful on what the
attributes mean and how they should be used:
https://tdg.docbook.org/tdg/4.5/replaceable
In the 5.2 version the text is slightly expanded but not by all that much:
https://tdg.docbook.org/tdg/5.2/replaceable
--
Daniel Gustafsson
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alvaro Herrera | 2023-10-04 15:00:26 | Re: --sync-method isn't documented to take an argument |
| Previous Message | Nathan Bossart | 2023-10-04 14:56:35 | Re: --sync-method isn't documented to take an argument |