Обсуждение: BUG #13469: Systematic typo in dblink documentation

Поиск
Список
Период
Сортировка

BUG #13469: Systematic typo in dblink documentation

От
brsaweda@gmail.com
Дата:
The following bug has been logged on the website:

Bug reference:      13469
Logged by:          Erwin Brandstetter
Email address:      brsaweda@gmail.com
PostgreSQL version: 9.4.4
Operating system:   OS independent, documentation bug
Description:

Affects all versions of the manual including /devel.

In the syntax description at the top for each dblink function, the argument
name is "connname" (with 3 n), but the reference to it in the text reads
"conname" (with 2 n).

http://www.postgresql.org/docs/current/interactive/contrib-dblink-connect.html
http://www.postgresql.org/docs/current/interactive/contrib-dblink-connect-u.html
Etc.

To stay in sync with the other argument "connstr", I suppose to use the
prefix "con" instead of "conn" for arguments globally in the dblink
documentation.

So:

  s/connname/conname/g
  s/connstr/constr/g


Regards
Erwin

Re: BUG #13469: Systematic typo in dblink documentation

От
Bruce Momjian
Дата:
On Thu, Jun 25, 2015 at 07:24:03PM +0000, brsaweda@gmail.com wrote:
> The following bug has been logged on the website:
>
> Bug reference:      13469
> Logged by:          Erwin Brandstetter
> Email address:      brsaweda@gmail.com
> PostgreSQL version: 9.4.4
> Operating system:   OS independent, documentation bug
> Description:
>
> Affects all versions of the manual including /devel.
>
> In the syntax description at the top for each dblink function, the argument
> name is "connname" (with 3 n), but the reference to it in the text reads
> "conname" (with 2 n).
>
> http://www.postgresql.org/docs/current/interactive/contrib-dblink-connect.html
> http://www.postgresql.org/docs/current/interactive/contrib-dblink-connect-u.html
> Etc.
>
> To stay in sync with the other argument "connstr", I suppose to use the
> prefix "con" instead of "conn" for arguments globally in the dblink
> documentation.
>
> So:
>
>   s/connname/conname/g
>   s/connstr/constr/g

I went the other way, and since "connstr" used two n's, I changed it to
connname (3 n's).  I assumed the prototypes were the canonical version.
Backpatched through 9.0.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + Everyone has their own god. +