From: Tom Lane <tgl@sss.pgh.pa.us>
To: Jürgen Purtz <juergen@purtz.de>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: obsolete indexing method "rtree"
Date: Wed, 05 Aug 2020 10:01:28 -0400
Message-ID: <2510904.1596636088@sss.pgh.pa.us> (raw)
In-Reply-To: <9cda4603-76d0-b063-5dc3-a9a99506340b@purtz.de>
References: <9cda4603-76d0-b063-5dc3-a9a99506340b@purtz.de>
=?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de> writes:
> We removed the indexing method "rtree" in version 8.3 and replaced it
> with "gist". Until today there are some "rtree" heritages:
> * "CREATE INDEX ... USING rtree ..." is valid syntax and leads to the
> message "NOTICE: substituting access method gist for obsolete
> method rtree"
> * The documentation refers to the method in ref/comments.sgml and
> ref/create_index.sgml.
> * The documentation uses the term "R-Tree" in gist.sgml, seg.sgml, and
> xindex.sgml. That's ok because in this cases it refers to the
> abstract concept of R-trees and not to the eliminated implementation.
> Isn't it time to disallow this syntax and remove all references and
> messages?
Why? It's not hurting anything to continue the substitution in CREATE
INDEX. The example in comments.sgml is just an example, and is not
meant to reflect a built-in object any more than the adjacent examples
are.
Possibly the comment in seg.sgml should be adjusted to refer to GiST
indexes --- but then again, it's not entirely clear whether it's even
still relevant for GiST indexes. Perhaps it's talking about a deficiency
that was specific to the old rtree code.
regards, tom lane
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: tgl@sss.pgh.pa.us, juergen@purtz.de, pgsql-docs@lists.postgresql.org
Subject: Re: obsolete indexing method "rtree"
In-Reply-To: <2510904.1596636088@sss.pgh.pa.us>
* 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