Content-Type: text/plain;
	charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.3\))
Subject: Re: --sync-method isn't documented to take an argument
From: Daniel Gustafsson <daniel@yesql.se>
In-Reply-To: <2586962.1696431119@sss.pgh.pa.us>
Date: Wed, 4 Oct 2023 16:56:54 +0200
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>,
 Robert Haas <robertmhaas@gmail.com>,
 PostgreSQL Hackers <pgsql-hackers@postgresql.org>,
 Nathan Bossart <nathandbossart@gmail.com>
Content-Transfer-Encoding: 7bit
Message-Id: <8CF2C172-4500-4A77-95DF-900F363D7196@yesql.se>
References: <202310041435.5ss4bpih2lal@alvherre.pgsql>
 <2585706.1696430390@sss.pgh.pa.us>
 <5FA50A84-6ECC-4280-AC2E-23F88C252713@yesql.se>
 <2586962.1696431119@sss.pgh.pa.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Archived-At: <https://www.postgresql.org/message-id/8CF2C172-4500-4A77-95DF-900F363D7196%40yesql.se>
Precedence: bulk

> On 4 Oct 2023, at 16:51, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> 
> Daniel Gustafsson <daniel@yesql.se> writes:
>> On 4 Oct 2023, at 16:39, Tom Lane <tgl@sss.pgh.pa.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