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

From Tom Lane
Subject pgsql: Doc: improve libpq service-file docs, avoid overspecifying pathn
Date
Msg-id E1ln3gV-0006ti-RP@gemulon.postgresql.org
Whole thread Raw
List 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 by date:

Previous
From: Thomas Munro
Date:
Subject: pgsql: Fix race condition when sharing tuple descriptors.
Next
From: Michael Paquier
Date:
Subject: pgsql: Improve some error wording with multirange type parsing