Connection Info
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/14/server-start.html
Description:
Hello!
On this page:
https://www.postgresql.org/docs/14/server-start.html#CLIENT-CONNECTION-PROBLEMS
It notes: ".... A common mistake is to forget to configure the server to
allow TCP/IP connections."
I would expect a hyperlink to a section explaining exactly HOW to "configure
the server to allow TCP/IP connections" - from that note text.
On Sun, 2024-05-05 at 20:25 +0000, PG Doc comments form wrote:
On this page:
https://www.postgresql.org/docs/14/server-start.html#CLIENT-CONNECTION-PROBLEMSIt notes: ".... A common mistake is to forget to configure the server to
allow TCP/IP connections."I would expect a hyperlink to a section explaining exactly HOW to "configure
the server to allow TCP/IP connections" - from that note text.
I agree.
Perhaps it should say:
A common mistake is to forget to configure "listen_addresses" so that the
server accepts remote TCP connections.
Then "listen_addresses" could hyperlink to the parameter's documentation.
Yours,
Laurenz Albe
On Mon, May 6, 2024 at 04:15:24PM +0200, Laurenz Albe wrote:
On Sun, 2024-05-05 at 20:25 +0000, PG Doc comments form wrote:
On this page:
https://www.postgresql.org/docs/14/server-start.html#CLIENT-CONNECTION-PROBLEMSIt notes: ".... A common mistake is to forget to configure the server to
allow TCP/IP connections."I would expect a hyperlink to a section explaining exactly HOW to "configure
the server to allow TCP/IP connections" - from that note text.I agree.
Perhaps it should say:
A common mistake is to forget to configure "listen_addresses" so that the
server accepts remote TCP connections.Then "listen_addresses" could hyperlink to the parameter's documentation.
Agreed, patch attached.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
When a patient asks the doctor, "Am I going to die?", he means
"Am I going to die soon?"
Attachments:
listen.difftext/x-diff; charset=us-asciiDownload+2-1
On Wed, Oct 16, 2024 at 09:36:00PM -0400, Bruce Momjian wrote:
On Mon, May 6, 2024 at 04:15:24PM +0200, Laurenz Albe wrote:
On Sun, 2024-05-05 at 20:25 +0000, PG Doc comments form wrote:
On this page:
https://www.postgresql.org/docs/14/server-start.html#CLIENT-CONNECTION-PROBLEMSIt notes: ".... A common mistake is to forget to configure the server to
allow TCP/IP connections."I would expect a hyperlink to a section explaining exactly HOW to "configure
the server to allow TCP/IP connections" - from that note text.I agree.
Perhaps it should say:
A common mistake is to forget to configure "listen_addresses" so that the
server accepts remote TCP connections.Then "listen_addresses" could hyperlink to the parameter's documentation.
Agreed, patch attached.
Patch applied.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
When a patient asks the doctor, "Am I going to die?", he means
"Am I going to die soon?"