Re: Add contrib module functions to docs' function index - Mailing list pgsql-hackers

From David Johnston
Subject Re: Add contrib module functions to docs' function index
Date
Msg-id 002101cdc1fa$7c5a2640$750e72c0$@yahoo.com
Whole thread Raw
In response to Add contrib module functions to docs' function index  (Craig Ringer <craig@2ndQuadrant.com>)
Responses Re: Add contrib module functions to docs' function index  (Craig Ringer <craig@2ndQuadrant.com>)
List pgsql-hackers
> -----Original Message-----
> From: pgsql-hackers-owner@postgresql.org [mailto:pgsql-hackers-
> owner@postgresql.org] On Behalf Of Craig Ringer
> Sent: Tuesday, November 13, 2012 6:15 PM
> To: PostgreSQL Hackers
> Subject: [HACKERS] Add contrib module functions to docs' function index
> 
> Hi all
> 
> Andreas Heiduk on -bugs suggested that we add the functions provided by
> contrib modules to the function index in the docs, so it's easier to go
from,
> say,  "what the heck is idx(...)" to finding it in the intarray contrib
module.
> 
> This seems like a good idea and I'd like to pop it in the TODO until I get
time to
> check it out, flagged as a minor/newbie-friendly problem.
> Any objections?
> 

For clarity does this proposal refer to Chapter 9 of the documentation, the
"Index", or both.

If modifying Chapter 9 the function and operator tables should be extended
to include a "source" column with values of "base" or "contrib: <module
name>" or something similar.

As to the desirability of such a change I concur that it would be a nice
usability enhancement to consider beyond just updating the actual "Index".

David J.







pgsql-hackers by date:

Previous
From: Craig Ringer
Date:
Subject: Add contrib module functions to docs' function index
Next
From: Bruce Momjian
Date:
Subject: Re: Further pg_upgrade analysis for many tables