Received: from maia.hub.org (maia-5.hub.org [200.46.204.29])
	by mail.postgresql.org (Postfix) with ESMTP id 531D21337B5E
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Tue, 25 Jan 2011 11:17:15 -0400 (AST)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024)
	with ESMTP id 46757-09 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Tue, 25 Jan 2011 15:17:10 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130])
	by mail.postgresql.org (Postfix) with ESMTP id CB05F1337B54
	for <pgsql-docs@postgresql.org>; Tue, 25 Jan 2011 11:17:07 -0400 (AST)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id p0PFH6BU021986;
	Tue, 25 Jan 2011 10:17:06 -0500 (EST)
To: Bruce Momjian <bruce@momjian.us>
cc: Josh Kupershmidt <schmiddy@gmail.com>,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: Doc reference of contrib modules 
In-reply-to: <201101251459.p0PExqj11486@momjian.us> 
References: <201101251459.p0PExqj11486@momjian.us>
Comments: In-reply-to Bruce Momjian <bruce@momjian.us>
	message dated "Tue, 25 Jan 2011 09:59:52 -0500"
Date: Tue, 25 Jan 2011 10:17:06 -0500
Message-ID: <21985.1295968626@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201101/30
X-Sequence-Number: 6322

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