From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | pgsql-committers(at)lists(dot)postgresql(dot)org |
Subject: | pgsql: Doc: improve libpq service-file docs, avoid overspecifying pathn |
Date: | 2021-05-29 18:27:43 |
Message-ID: | E1ln3gV-0006ti-RP@gemulon.postgresql.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | 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(-)
From | Date | Subject | |
---|---|---|---|
Next Message | Michael Paquier | 2021-05-31 02:35:35 | pgsql: Improve some error wording with multirange type parsing |
Previous Message | Thomas Munro | 2021-05-29 03:49:42 | pgsql: Fix race condition when sharing tuple descriptors. |