pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedpgsql: Add index entries for more functions
4+ messages / 2 participants
[nested] [flat]
* pgsql: Add index entries for more functions
@ 2010-11-23 22:03 Peter Eisentraut <peter_e@gmx.net>
2010-11-28 23:59 ` Re: pgsql: Add index entries for more functions Thom Brown <thom@linux.com>
0 siblings, 1 reply; 4+ messages in thread
From: Peter Eisentraut @ 2010-11-23 22:03 UTC (permalink / raw)
To: pgsql-committers@postgresql.org
Add index entries for more functions
Also, move index entries into the tables, closer to the function description,
for easier editing in the future. Resort some tables to be more alphabetical.
Remove the entries for count, max, min, and sum in the tutorial area, because
that was felt to be confusing.
Thom Brown
Branch
------
master
Details
-------
http://git.postgresql.org/gitweb?p=postgresql.git;a=commitdiff;h=4fc09ad00c3cc95003a5523d85999da1dd4...
Modified Files
--------------
doc/src/sgml/func.sgml | 1781 ++++++++++++++++++++++++++++++-----------------
doc/src/sgml/query.sgml | 6 -
2 files changed, 1141 insertions(+), 646 deletions(-)
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: pgsql: Add index entries for more functions
2010-11-23 22:03 pgsql: Add index entries for more functions Peter Eisentraut <peter_e@gmx.net>
@ 2010-11-28 23:59 ` Thom Brown <thom@linux.com>
2010-11-30 17:55 ` Re: [COMMITTERS] pgsql: Add index entries for more functions Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 4+ messages in thread
From: Thom Brown @ 2010-11-28 23:59 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-committers@postgresql.org
On 23 November 2010 22:03, Peter Eisentraut <peter_e@gmx.net> wrote:
> Add index entries for more functions
>
> Also, move index entries into the tables, closer to the function description,
> for easier editing in the future. Resort some tables to be more alphabetical.
> Remove the entries for count, max, min, and sum in the tutorial area, because
> that was felt to be confusing.
>
> Thom Brown
>
> Branch
> ------
> master
>
> Details
> -------
> http://git.postgresql.org/gitweb?p=postgresql.git;a=commitdiff;h=4fc09ad00c3cc95003a5523d85999da1dd4...
>
> Modified Files
> --------------
> doc/src/sgml/func.sgml | 1781 ++++++++++++++++++++++++++++++-----------------
> doc/src/sgml/query.sgml | 6 -
> 2 files changed, 1141 insertions(+), 646 deletions(-)
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?
--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: [COMMITTERS] pgsql: Add index entries for more functions
2010-11-23 22:03 pgsql: Add index entries for more functions Peter Eisentraut <peter_e@gmx.net>
2010-11-28 23:59 ` Re: pgsql: Add index entries for more functions Thom Brown <thom@linux.com>
@ 2010-11-30 17:55 ` Peter Eisentraut <peter_e@gmx.net>
2010-11-30 17:57 ` Re: [COMMITTERS] pgsql: Add index entries for more functions Thom Brown <thom@linux.com>
0 siblings, 1 reply; 4+ messages in thread
From: Peter Eisentraut @ 2010-11-30 17:55 UTC (permalink / raw)
To: Thom Brown <thom@linux.com>; +Cc: pgsql-docs
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
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: [COMMITTERS] pgsql: Add index entries for more functions
2010-11-23 22:03 pgsql: Add index entries for more functions Peter Eisentraut <peter_e@gmx.net>
2010-11-28 23:59 ` Re: pgsql: Add index entries for more functions Thom Brown <thom@linux.com>
2010-11-30 17:55 ` Re: [COMMITTERS] pgsql: Add index entries for more functions Peter Eisentraut <peter_e@gmx.net>
@ 2010-11-30 17:57 ` Thom Brown <thom@linux.com>
0 siblings, 0 replies; 4+ messages in thread
From: Thom Brown @ 2010-11-30 17:57 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On 30 November 2010 17:55, Peter Eisentraut <peter_e@gmx.net> wrote:
> 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
Okay, fair enough. :)
--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2010-11-30 17:57 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2010-11-23 22:03 pgsql: Add index entries for more functions Peter Eisentraut <peter_e@gmx.net>
2010-11-28 23:59 ` Thom Brown <thom@linux.com>
2010-11-30 17:55 ` Peter Eisentraut <peter_e@gmx.net>
2010-11-30 17:57 ` Thom Brown <thom@linux.com>
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