Why?
Because it can hinder the learning process. And it's possible that
people ignore or forget about the warning message, but are confused
somewhat later that commands like \d shows GiST instead of RTREE.
It's not hurting anything to continue the substitution in CREATE
INDEX.
Yes, it's not hurting. But it makes the life of newcomers a little
harder. Why not stripping away thinks which aren't used since 12 years?
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.
This comment is not specific to the old rtree implementation. In
general, the input to R-Trees and the algorithm which creates the
'rectangles' in non-leaf nodes influences the building of the tree and
hereinafter the performance of access methods.
Perhaps it's talking about a deficiency
that was specific to the old rtree code.
And sometimes even experts have to spend time thinking about the situation.
Nevertheless, this is a tiny issue. Unfortunately I don't have the
knowledge to modify the C-source and create a patch.
--
Jürgen Purtz