Re: ALTER SYSTEM is equal to editing postgresql.auto.conf, not postgres.conf

From: Michael Paquier <michael(dot)paquier(at)gmail(dot)com>
To: vodevsh(at)gmail(dot)com
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: ALTER SYSTEM is equal to editing postgresql.auto.conf, not postgres.conf
Date: 2017-07-13 10:57:06
Message-ID: CAB7nPqRRHDtn_n+w9LVHLqW-Ggyf+=LtFnvNepA46+VoGgeNVA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Jul 13, 2017 at 12:53 PM, <vodevsh(at)gmail(dot)com> wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.6/static/config-setting.html
> Description:
>
> &gt; The already-mentioned ALTER SYSTEM command provides a SQL-accessible means
> of changing global defaults; it is functionally equivalent to editing
> postgresql.conf
>
> Should not it be ...to editing postgresql.auto.conf?.. I know user is not
> supposed to edit postgresql.auto.conf but this is what ALTER SYSTEM does,
> not touching the postgres.conf - isn&#39;t is confusing in manual?..

The documentation looks correctly shaped to me per this paragraph
above the one you mention here:
In addition to postgresql.conf, a PostgreSQL data directory contains a
file postgresql.auto.conf, which has the same format as
postgresql.conf but should never be edited manually.

So, citing postgresql.conf, which can be edited manually, looks correct to me.
--
Michael

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message dwe 2017-07-13 14:19:25 The format/layout of the tables seems to be broken
Previous Message vodevsh 2017-07-13 10:53:38 ALTER SYSTEM is equal to editing postgresql.auto.conf, not postgres.conf