From: Peter Eisentraut <peter_e@gmx.net>
To: Thom Brown <thom@linux.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: [COMMITTERS] pgsql: Add index entries for more functions
Date: Tue, 30 Nov 2010 19:55:48 +0200
Message-ID: <1291139748.13957.6.camel@vanquo.pezone.net> (raw)
In-Reply-To: <AANLkTinVncuzW-wFnDdF0J8eqFrP2aUwcTZwyiuTGH=-@mail.gmail.com>
References: <E1PL0xu-00027P-5M@gemulon.postgresql.org>
<AANLkTinVncuzW-wFnDdF0J8eqFrP2aUwcTZwyiuTGH=-@mail.gmail.com>
On sön, 2010-11-28 at 23:59 +0000, Thom Brown wrote:
> Whilst looking at the latest build of the docs at
> http://developer.postgresql.org/pgdocs/postgres/bookindex.html I've
> noticed a discrepancy in this commit from the patch I provided. I
> specified "average" as a primary term with "avg" as a secondary term,
> but the commit shows them both as separate primary entries. Was this
> changed intentionally?
Yes.
I have no written reference for this, but from experience, my
understanding of the way index entries should work is that the primary
term is something you would look up, and the secondary term is something
you would look up among the primary terms.
So I think a reader would probably look up both "avg" because that's the
function he's using, and "average" because that's the term for what he's
trying to do.
Somewhat made up examples of what reasonable secondary terms might be:
avg,
for user-defined types
performance of
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: peter_e@gmx.net, thom@linux.com
Subject: Re: [COMMITTERS] pgsql: Add index entries for more functions
In-Reply-To: <1291139748.13957.6.camel@vanquo.pezone.net>
* 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