public inbox for [email protected]
help / color / mirror / Atom feedPushing btree opclass implementor's docs to the main SGML docs
3+ messages / 2 participants
[nested] [flat]
* Pushing btree opclass implementor's docs to the main SGML docs
@ 2018-02-05 23:51 Tom Lane <[email protected]>
2018-02-06 19:43 ` Re: Pushing btree opclass implementor's docs to the main SGML docs Peter Eisentraut <[email protected]>
0 siblings, 1 reply; 3+ messages in thread
From: Tom Lane @ 2018-02-05 23:51 UTC (permalink / raw)
To: [email protected]
I whined in <[email protected]> about the lack of any good
place in the main documentation to explain how to write in_range() support
functions for the upcoming window RANGE patch.
What I would like to do, to create such a place, is to move the last
section of src/backend/access/nbtree/README (the "Notes to Operator Class
Implementors" part) into the main docs. There are really two subparts
to that: there's some rather abstract handwaving about the mathematical
properties of a btree ordering, and then there's an API spec for the
comparison support function. The RANGE patch would want to add an API
spec for the in_range function. (At some point somebody might feel like
adding some text about the sortsupport API too; though since it's
basically impossible to do sortsupport except in C, I don't feel too bad
about just pointing to sortsupport.h for now.)
So I can see two ways to approach this: add two new subsections at the end
of xindex.sgml, or create a new chapter about b-trees in Part VII
("Internals") to go beside the existing ones about the more recently added
index types. The latter would make more sense if anyone was inspired to
write something comparable in length to the existing per-index-type
chapters. But I'm not volunteering to do that, so if it's a chapter it'd
be a mighty thin one to start with.
Anybody have a preference, an objection, or a better idea?
regards, tom lane
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Pushing btree opclass implementor's docs to the main SGML docs
2018-02-05 23:51 Pushing btree opclass implementor's docs to the main SGML docs Tom Lane <[email protected]>
@ 2018-02-06 19:43 ` Peter Eisentraut <[email protected]>
2018-02-06 20:26 ` Re: Pushing btree opclass implementor's docs to the main SGML docs Tom Lane <[email protected]>
0 siblings, 1 reply; 3+ messages in thread
From: Peter Eisentraut @ 2018-02-06 19:43 UTC (permalink / raw)
To: Tom Lane <[email protected]>; [email protected]
On 2/5/18 18:51, Tom Lane wrote:
> So I can see two ways to approach this: add two new subsections at the end
> of xindex.sgml, or create a new chapter about b-trees in Part VII
> ("Internals") to go beside the existing ones about the more recently added
> index types. The latter would make more sense if anyone was inspired to
> write something comparable in length to the existing per-index-type
> chapters. But I'm not volunteering to do that, so if it's a chapter it'd
> be a mighty thin one to start with.
xindex seems better to me.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Pushing btree opclass implementor's docs to the main SGML docs
2018-02-05 23:51 Pushing btree opclass implementor's docs to the main SGML docs Tom Lane <[email protected]>
2018-02-06 19:43 ` Re: Pushing btree opclass implementor's docs to the main SGML docs Peter Eisentraut <[email protected]>
@ 2018-02-06 20:26 ` Tom Lane <[email protected]>
0 siblings, 0 replies; 3+ messages in thread
From: Tom Lane @ 2018-02-06 20:26 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: [email protected]
Peter Eisentraut <[email protected]> writes:
> On 2/5/18 18:51, Tom Lane wrote:
>> So I can see two ways to approach this: add two new subsections at the end
>> of xindex.sgml, or create a new chapter about b-trees in Part VII
>> ("Internals") to go beside the existing ones about the more recently added
>> index types. The latter would make more sense if anyone was inspired to
>> write something comparable in length to the existing per-index-type
>> chapters. But I'm not volunteering to do that, so if it's a chapter it'd
>> be a mighty thin one to start with.
> xindex seems better to me.
Oh, I already did it as a chapter. I'm inclined to think that somebody
will want to write something more there someday, and anyway it's already
longer than some existing chapters ...
regards, tom lane
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2018-02-06 20:26 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-02-05 23:51 Pushing btree opclass implementor's docs to the main SGML docs Tom Lane <[email protected]>
2018-02-06 19:43 ` Peter Eisentraut <[email protected]>
2018-02-06 20:26 ` Tom Lane <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox