pgsql: Doc: improve libpq service-file docs, avoid overspecifying pathn

Поиск
Список
Период
Сортировка
От Tom Lane
Тема pgsql: Doc: improve libpq service-file docs, avoid overspecifying pathn
Дата
Msg-id E1ln3gV-0006ti-RP@gemulon.postgresql.org
обсуждение исходный текст
Список pgsql-committers
Doc: improve libpq service-file docs, avoid overspecifying pathnames.

Clarify libpq.sgml's description of service file locations and
semantics.  Avoid use of backtick'ed pg_config calls to describe
paths; that doesn't work on Windows, and even on Unix it's an
idiom that not all readers may be instantly familiar with.

Don't overspecify the locations of include files, instead writing
only as much as you'd use in #include directives.  The previous text
in these places was incorrect for some installations, depending on
where "postgresql" is in the install path.

Our convention for referencing the user's home directory seems
to be "~", so change the one place that spelled it "$HOME".

install-windows.sgml follows the platform convention of spelling
file paths with "\", so change the one place that used "/".

Haiying Tang and Tom Lane

Discussion: https://postgr.es/m/162149020918.26174.7150424047314144297@wrigleys.postgresql.org

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/ba356a397de565c014384aa01a945aab7d50928c

Modified Files
--------------
doc/src/sgml/config.sgml          |  2 +-
doc/src/sgml/install-windows.sgml |  2 +-
doc/src/sgml/libpq.sgml           | 48 +++++++++++++++++++++++++++------------
doc/src/sgml/pgbuffercache.sgml   |  2 +-
4 files changed, 36 insertions(+), 18 deletions(-)


В списке pgsql-committers по дате отправления:

Предыдущее
От: Thomas Munro
Дата:
Сообщение: pgsql: Fix race condition when sharing tuple descriptors.
Следующее
От: Michael Paquier
Дата:
Сообщение: pgsql: Improve some error wording with multirange type parsing