Discrepancy between the documentation and the implementation

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: elkzwix(at)gmail(dot)com
Subject: Discrepancy between the documentation and the implementation
Date: 2023-10-25 15:20:11
Message-ID: 169824721149.1769274.1553568436817652238@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/ecpg-sql-set-connection.html
Description:

In the documentation for Postgres 15, on page
https://www.postgresql.org/docs/15/ecpg-sql-set-connection.html, it states
that one can write:

SET CONNECTION connection_name

And under that, it talks about "connection_name" and DEFAULT, which is
supposed to be used in order to use the "default connection".
However, "SET CONNECTION DEFAULT" is treated by ECPG as a normal connection
name (looking for a connection named "DEFAULT"), not as a special keyword
meaning to go back to using the "default" connection.

Is there something I'm missing there ? The documentation is kinda
misleading, in its current form. Or is there a limitation with ECPG, which
prevents the use of DEFAULT, while it would work with other tools ?

(This is written in the same way for numerous Postgres versions, it's not
limited to version 15)

Regards,
Sylvain FRANDAZ

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2023-10-25 15:44:04 19.9. Secure TCP/IP Connections with SSL
Previous Message Daniel Gustafsson 2023-10-25 09:37:35 Re: Wrong link in the documentation for versions 11, 12