Received: from malur.postgresql.org ([217.196.149.56])
 by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7739=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1UulXV-0000Yv-4C
 for pgsql-docs@arkaria.postgresql.org; Thu, 04 Jul 2013 15:33:45 +0000
Received: from localhost ([127.0.0.1] helo=postgresql.org)
 by malur.postgresql.org with smtp (Exim 4.80) (envelope-from
 <pgsql-docs-owner+M7739=pgsql+2Ddocs=arkaria.postgresql.org@postgresql.org>)
 id 1UulXU-0006nC-JL
 for pgsql-docs@arkaria.postgresql.org; Thu, 04 Jul 2013 15:33:44 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
 by malur.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <bruce@momjian.us>) id 1UulXT-0006m4-HX
 for pgsql-docs@postgresql.org; Thu, 04 Jul 2013 15:33:43 +0000
Received: from momjian.us ([72.94.173.45])
 by magus.postgresql.org with esmtp (Exim 4.80)
 (envelope-from <bruce@momjian.us>) id 1UulXQ-0006gP-5I
 for pgsql-docs@postgresql.org; Thu, 04 Jul 2013 15:33:42 +0000
Received: from bruce by momjian.us with local (Exim 4.72)
 (envelope-from <bruce@momjian.us>)
 id 1UulXM-0003hY-Dm; Thu, 04 Jul 2013 11:33:36 -0400
Date: Thu, 4 Jul 2013 11:33:36 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Craig Ringer <craig@2ndquadrant.com>, David Johnston <polobo@yahoo.com>,
 PostgreSQL-documentation <pgsql-docs@postgresql.org>
Subject: Re: [HACKERS] Add contrib module functions to docs'
 function index
Message-ID: <20130704153336.GB17790@momjian.us>
References: <50A2D489.7020102@2ndQuadrant.com>
 <002101cdc1fa$7c5a2640$750e72c0$@yahoo.com>
 <50A2E173.6030404@2ndQuadrant.com>
 <CA+Tgmob7mUzmxjROiHsY4r2XE=iUzOxrpjuDVy7jsdi2tV=6zw@mail.gmail.com>
 <20130702195610.GD5361@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20130702195610.GD5361@momjian.us>
User-Agent: Mutt/1.5.20 (2009-06-14)
X-Pg-Spam-Score: -2.1 (--)
List-Archive: <http://archives.postgresql.org/pgsql-docs>
List-Help: <mailto:majordomo@postgresql.org?body=help>
List-ID: <pgsql-docs.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@postgresql.org>
List-Post: <mailto:pgsql-docs@postgresql.org>
List-Subscribe: <mailto:majordomo@postgresql.org?body=sub%20pgsql-docs>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
X-Mailing-List: pgsql-docs
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

On Tue, Jul  2, 2013 at 03:56:10PM -0400, Bruce Momjian wrote:
> On Wed, Nov 14, 2012 at 05:46:57PM -0500, Robert Haas wrote:
> > On Tue, Nov 13, 2012 at 7:10 PM, Craig Ringer <craig@2ndquadrant.com> wrote:
> > > I'm talking about making sure that contrib module functions (and settings)
> > > appear in the documentation index (
> > > http://www.postgresql.org/docs/current/static/bookindex.html) so it's easy
> > > to find a function by name whether it's in core or contrib. This is what I
> > > want to add to TODO.
> > 
> > +1.
> > 
> > > Separately, it might also be nice to add the contrib functions to the
> > > section 9 tables with an extra column showing their origin, but that's less
> > > clearly a good thing. Even if there's a column saying "intarray" for
> > > intarray functions in the array functions list, people will still try to use
> > > them without loading the extension and get confused when they're not found.
> > > It'll also bloat the listings of core functions. Rather than do that, I'd
> > > probably prefer to add a note to relevant sections. For example, in array
> > > functions I'd want to add "Additional functions that operate only on arrays
> > > of integers are available in the <a href="...">intarray extension</a>".
> > 
> > The second approach seems better, and maybe only in cases where it's
> > particularly relevant.
> 
> Seems we never considered index entries when we moved the contrib
> information into our main docs.
> 
> I have developed the this patch to do this.  I would like to apply
> this to head and 9.3:
> 
> 	http://momjian.us/expire/contrib.diff

Applied, and backpatched to 9.3.  Craig, thanks for the suggestion.

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

  + It's impossible for everything to be true. +


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs