On Mon, Aug 31, 2020 at 08:42:57PM -0400, Bruce Momjian wrote:
> On Thu, Aug 27, 2020 at 09:51:49PM -0700, David G. Johnston wrote:
> > On Thu, Aug 27, 2020 at 6:17 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
> >
> > PG Doc comments form <noreply@postgresql.org> writes:
> > > The following documentation comment has been logged on the website:
> > > Page: https://www.postgresql.org/docs/9.5/ssh-tunnels.html
> > > Description:
> >
> > > "The first number in the -L argument, 63333, is the port number of your
> > end
> > > of the tunnel; it can be any unused port. (IANA reserves ports 49152
> > through
> > > 65535 for private use.) The second number, 5432, is the remote end of the
> > > tunnel: the port number your server is using. "
> >
> > > as a beginner This took me some time to understand what do you mean by
> > "your
> > > server" "your end of the tunnel "
> >
> > Hm, do you have a suggestion for better wording?
> >
> >
> >
> > I agree on the need for a different perspective here since it reads just fine
> > once you know what it is talking about.
> >
> > But absent that maybe a slightly more tutorial flow would be good.
>
> I didn't think a tutorial flow was the right thing to here, so I
> reworded the section to be more details and have a clearer flow ---
> patch attached.
Patch applied to all supported versions. Thanks for the report.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EnterpriseDB https://enterprisedb.com
The usefulness of a cup is in its emptiness, Bruce Lee