Skip site navigation (1) Skip section navigation (2)

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 (view raw or flat)
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

pgsql-docs by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group