Date: Fri, 2 Oct 2020 21:40:04 -0400
From: Bruce Momjian <bruce@momjian.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, karimelghazouly@gmail.com,
	Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: small clairifcation
Message-ID: <20201003014004.GB17425@momjian.us>
References: <159854511172.24991.4373145230066586863@wrigleys.postgresql.org>
 <3379769.1598577411@sss.pgh.pa.us>
 <CAKFQuwZZ2k0p=x1MPwGWQh1v8prq_efvNBs8ncsxrWOyd+45cg@mail.gmail.com>
 <20200901004257.GU13613@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20200901004257.GU13613@momjian.us>
User-Agent: Mutt/1.10.1 (2018-07-13)
Precedence: bulk

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