pgsql: doc: Fix description of $system in extension_control_path
doc: Fix description of $system in extension_control_path
The documentation specifies that a list element of extension_control_path
that starts with $system gets the system extension directory substituted
for it. However, get_extension_control_directories() only recognizes an
element that is exactly "$system" since commit 81eaaa2c41d.
Any other element, like "$system/foo", is taken as a literal path with
the "extension" suffix appended, so CREATE EXTENSION fails with a "not
an absolute path" error, while pg_available_extensions silently returns
no rows for it.
Expanding $system as a prefix doesn't fit well with the path elements
being base directories to which "extension" is appended, since $system
already points to the extension directory itself. So, rather than
changing the behavior, fix the documentation to say that the element
must be exactly $system.
While at it, clarify that $system is the "extension" subdirectory of
pg_config --sharedir and that the "extension" suffix is not appended
to it.
Backpatch to 18, where the current behavior was introduced.
Author: Matheus Alcantara <mths.dev@pm.me>
Reviewed-by: Mahendrakar Srinivasarao <mahendrakarforpg@gmail.com>
Reviewed-by: Chao Li <li.evan.chao@gmail.com>
Discussion: /messages/by-id/DMQTNLET8EKG.2BKGGLIOA4OQY@gmail.com
Backpatch-through: 18
Branch
------
REL_19_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/4fba8bb0e57c3c281cbf28f4b5e172ca89baae03
Modified Files
--------------
doc/src/sgml/config.sgml | 13 ++++++++-----
1 file changed, 8 insertions(+), 5 deletions(-)