Re: Bogus documentation for bogus geometric operators
| От | Pavel Borisov |
|---|---|
| Тема | Re: Bogus documentation for bogus geometric operators |
| Дата | |
| Msg-id | CALT9ZEELPyV6yMbLV-c-B8z2MAJTEkW4f-qxxVUKnAZCoaz1bw@mail.gmail.com обсуждение исходный текст |
| Ответ на | Re: Bogus documentation for bogus geometric operators (Tom Lane <tgl@sss.pgh.pa.us>) |
| Ответы |
Re: Bogus documentation for bogus geometric operators
|
| Список | pgsql-hackers |
1. The patch removes <^ and >^ from func.sgml, which is fine, but
shouldn't there be an addition for the new operators? (I think
I fully agree and added "point" as a possible input type for <<| and |>> in manual. PFA v5
undocumented. Maybe instead of removing, change the text to be
"Deprecated, use the equivalent XXX operator instead." Or we could
add a footnote similar to what was there for a previous renaming:
The problem that this new <<| is equivalent to <^ only for points (To recap: the source of a problem is the same name of <^ operator for points and boxes with different meaning for these types).
point box
<<| |>> strictly above/below (new) strictly above/below
<^ >^ strictly above/below (deprecated, but available) above/below
So it seems to me that trying to mention the subtle difference of deprecated operator to same-named one for different data type inevitably make things much worse for reader. On this reason I'd vote for complete nuking <^ for point type (but this is not the only way so I haven't done this in v5).
What do you think?
Вложения
В списке pgsql-hackers по дате отправления: