Re: Doc reference of contrib modules - Mailing list pgsql-docs

From Josh Kupershmidt
Subject Re: Doc reference of contrib modules
Date
Msg-id AANLkTin7bNN+RFguFVT6JYK7ibA9B9Lzn=s1WuvaYJJE@mail.gmail.com
Whole thread Raw
In response to Re: Doc reference of contrib modules  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Doc reference of contrib modules  (Bruce Momjian <bruce@momjian.us>)
List pgsql-docs
On Mon, Jan 24, 2011 at 10:33 PM, Bruce Momjian <bruce@momjian.us> wrote:
> Suggestions?

For this bit:

*** 686,693 ****
        AS t1(proname name, prosrc text)
      WHERE proname LIKE 'bytea%';
  </programlisting>
!      The <literal>dblink</> function executes a remote query (see
!      <filename>contrib/dblink</>).  It is declared to return
       <type>record</> since it might be used for any kind of query.
       The actual column set must be specified in the calling query so
       that the parser knows, for example, what <literal>*</> should
--- 686,693 ----
        AS t1(proname name, prosrc text)
      WHERE proname LIKE 'bytea%';
  </programlisting>
!      The <link linkend="CONTRIB-DBLINK">dblink</> function executes
!      a remote query.  It is declared to return
       <type>record</> since it might be used for any kind of query.
       The actual column set must be specified in the calling query so
       that the parser knows, for example, what <literal>*</> should

I think the changed line should explicitly mention "dblink module",
otherwise it's easy to miss that dblink() comes from contrib.
Especially since the target page of that link:
  http://www.postgresql.org/docs/current/static/contrib-dblink.html
doesn't mention the words "contrib" or "module" anywhere (most other
contrib modules have a header saying "Appendix F. Additional Supplied
Modules" at the top of the page, but the dblink function pages don't
since they're subpages of
http://www.postgresql.org/docs/current/static/dblink.html ).

Josh

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Doc reference of contrib modules
Next
From: Bruce Momjian
Date:
Subject: Re: Doc reference of contrib modules