SP-GIST docs and examples
I know Oleg has been discussing quad trees for years now, so SP-GIST
sounds like a great feature.
The docs on SP-GIST simply suggest people read the code, which is way
below our normal standard of documentation.
CREATE INDEX contains no examples involving SP-GIST indexes.
It seems likely that the first thing a user will ask is When can I use
it? How do I create one? When should I use it in comparison with
existing methods?
ISTM that if we mention this as a major feature in 9.2, and I think we
should, that there should be something more about these in the shared
docs.
--
Simon Riggs http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services
On Thursday, June 7, 2012, Simon Riggs wrote:
I know Oleg has been discussing quad trees for years now, so SP-GIST
sounds like a great feature.The docs on SP-GIST simply suggest people read the code, which is way
below our normal standard of documentation.
It's the same we have for normal GiST indexes, no? It's under "internals",
I think it's ok in there.
CREATE INDEX contains no examples involving SP-GIST indexes.
It seems likely that the first thing a user will ask is When can I use
it? How do I create one? When should I use it in comparison with
existing methods?
This is the problem though - it only has internals documentation, and no
end-user documentation.
Not sure GiST has that much end-user documentation either. And it is
included in things like the FTI docs.
ISTM that if we mention this as a major feature in 9.2, and I think we
should, that there should be something more about these in the shared
docs.
+1, it should definitely get some more docs if possible.
//Magnus
--
Magnus Hagander
Me: http://www.hagander.net/
Work: http://www.redpill-linpro.com/
On Thu, Jun 7, 2012 at 5:19 AM, Simon Riggs <simon@2ndquadrant.com> wrote:
I know Oleg has been discussing quad trees for years now, so SP-GIST
sounds like a great feature.The docs on SP-GIST simply suggest people read the code, which is way
below our normal standard of documentation.
I completely agree. The GIN and GIST documentation are pretty
deficient as well.
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
On 7 June 2012 12:52, Robert Haas <robertmhaas@gmail.com> wrote:
On Thu, Jun 7, 2012 at 5:19 AM, Simon Riggs <simon@2ndquadrant.com> wrote:
I know Oleg has been discussing quad trees for years now, so SP-GIST
sounds like a great feature.The docs on SP-GIST simply suggest people read the code, which is way
below our normal standard of documentation.I completely agree. The GIN and GIST documentation are pretty
deficient as well.
Didn't Andrew Gierth volunteer to help rewrite those some time back?
Maybe nudge him about it again.
--
Thom
On Thu, 7 Jun 2012, Thom Brown wrote:
On 7 June 2012 12:52, Robert Haas <robertmhaas@gmail.com> wrote:
On Thu, Jun 7, 2012 at 5:19 AM, Simon Riggs <simon@2ndquadrant.com> wrote:
I know Oleg has been discussing quad trees for years now, so SP-GIST
sounds like a great feature.The docs on SP-GIST simply suggest people read the code, which is way
below our normal standard of documentation.I completely agree. The GIN and GIST documentation are pretty
deficient as well.Didn't Andrew Gierth volunteer to help rewrite those some time back?
Maybe nudge him about it again.
Oh, please !
Regards,
Oleg
_____________________________________________________________
Oleg Bartunov, Research Scientist, Head of AstroNet (www.astronet.ru),
Sternberg Astronomical Institute, Moscow University, Russia
Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
phone: +007(495)939-16-83, +007(495)939-23-83