Thread: Connection Info

Connection Info

From
PG Doc comments form
Date:
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.

Re: Connection Info

From
Laurenz Albe
Date:
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-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.

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



Re: Connection Info

From
Bruce Momjian
Date:
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-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.
> > 
> > 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?"