public inbox for [email protected]  
help / color / mirror / Atom feed
From: Tom Lane <[email protected]>
To: [email protected]
Subject: Where's the line between "extension" and "development"?
Date: Tue, 21 Oct 2003 16:16:28 -0400
Message-ID: <[email protected]> (raw)

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




reply

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: [email protected]
  Cc: [email protected]
  Subject: Re: Where's the line between "extension" and "development"?
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox