Doc: improve libpq service-file docs, avoid overspecifying pathnames.
authorTom Lane <tgl@sss.pgh.pa.us>
Sat, 29 May 2021 18:27:37 +0000 (14:27 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Sat, 29 May 2021 18:27:37 +0000 (14:27 -0400)
commitba356a397de565c014384aa01a945aab7d50928c
tree2fa5d2b7c094e460e76d73b648b9569b2c44314a
parentb1d6538903504904db44679355ac109aeda01737
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
doc/src/sgml/config.sgml
doc/src/sgml/install-windows.sgml
doc/src/sgml/libpq.sgml
doc/src/sgml/pgbuffercache.sgml