From: Tom Lane <tgl@sss.pgh.pa.us>
To: Igor Korot <ikorot01@gmail.com>
cc: Daniel Gustafsson <daniel@yesql.se>,
        Laurenz Albe <laurenz.albe@cybertec.at>,
        "pgsql-generallists.postgresql.org" <pgsql-general@lists.postgresql.org>
Subject: Re: Another documentation issue
In-reply-to: <CA+FnnTz5tbFf_sHmfkGQZTquxDDgdfq5UVmh0gCSQGPbtoT0vw@mail.gmail.com>
References: <CA+FnnTxPHoCZz2JBFxC3Wdsce9KUwNL0KcH5Ua37R55XLQbrpg@mail.gmail.com> <03763b6b43cfd8a7194c2fb06452178db4256494.camel@cybertec.at> <4B9E0CAC-FB06-4F35-8C77-33AEA7F741B7@yesql.se> <1430373.1745432896@sss.pgh.pa.us> <CA+FnnTz5tbFf_sHmfkGQZTquxDDgdfq5UVmh0gCSQGPbtoT0vw@mail.gmail.com>
Comments: In-reply-to Igor Korot <ikorot01@gmail.com>
	message dated "Wed, 23 Apr 2025 13:32:50 -0500"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <1431981.1745433654.1@sss.pgh.pa.us>
Content-Transfer-Encoding: 8bit
Date: Wed, 23 Apr 2025 14:40:54 -0400
Message-ID: <1431982.1745433654@sss.pgh.pa.us>
Archived-At: <https://www.postgresql.org/message-id/1431982.1745433654%40sss.pgh.pa.us>
Precedence: bulk

Igor Korot <ikorot01@gmail.com> writes:
> On Wed, Apr 23, 2025 at 1:28 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> If we do anything about this, I'd just say "systems that have
>> posix_fadvise()".  If we write something more specific it's likely to
>> become obsolete, and it doesn't seem to me that it's hard for someone
>> to research "does my box have posix_fadvise()?

> Imagine a person that wants to write a program which will cover creating
> the table space.
> Such person needs to cover the appropriate fields with possible values.
> Is there a #define such person should check to cover the appropriate values?

HAVE_POSIX_FADVISE.  Seems to me it'd be way easier to find that
from documentation that mentions posix_fadvise than from documentation
that says "it works on systems X, Y, Z".

			regards, tom lane