Where's the line between "extension" and "development"?

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-docs(at)postgreSQL(dot)org
Subject: Where's the line between "extension" and "development"?
Date: 2003-10-21 20:16:28
Message-ID: 5717.1066767388@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

I am thinking about moving chapter 34 (Index Cost Estimation Functions)
and section 33.9 (Procedural Language Handlers) out of Part V (Server
Programming) and into Part VII (Internals), on the grounds that
they are only of interest to hard-core developers. The other stuff in
Server Programming is of use to mere mortals who just want to get
their work done, but these sections don't seem to be addressing the
same audience. In particular it seems weird that documentation on how
to write a new procedural language comes before any of the documentation
on how to use the existing PLs.

I'm also inclined to push chapters 36 (Triggers) and 37 (SPI) to the end
of Part V, after the chapters on procedural languages, because these
two chapters are only of interest to authors of C-language functions.
This would help maintain the general structure of the part: simpler,
easier-to-use stuff before advanced stuff.

Comments?

regards, tom lane

Browse pgsql-docs by date

  From Date Subject
Next Message Christopher Kings-Lynne 2003-10-22 02:21:30 7.4 compatibility question
Previous Message Josh Berkus 2003-10-21 16:51:33 Re: Clarification in create_function.sgml