From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: Josh Kupershmidt <schmiddy@gmail.com>
Cc: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Doc reference of contrib modules
Date: Tue, 25 Jan 2011 10:17:06 -0500
Message-ID: <21985.1295968626@sss.pgh.pa.us> (raw)
In-Reply-To: <201101251459.p0PExqj11486@momjian.us>
References: <201101251459.p0PExqj11486@momjian.us>
Bruce Momjian <bruce@momjian.us> writes:
> That is an interesting case. I didn't mention "module" here because
> above this ia a dblink() function call, and we are referencing the
> function call in the text. I couldn't figure out how to mention
> "module" here without making the text more complex. I thought of:
> The <link linkend="CONTRIB-DBLINK">dblink</> function (part of the
> dblink module) executes a remote query.
> but that seems awkward. Ideas?
That's not just awkward, but flat wrong, because the link points to
documentation of the module not the function. Correct would be
something like
The <function>dblink()</> function (part of the
<link linkend="CONTRIB-DBLINK">dblink</> module) executes a remote query.
regards, tom lane
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, bruce@momjian.us, schmiddy@gmail.com
Subject: Re: Doc reference of contrib modules
In-Reply-To: <21985.1295968626@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox