From: Bruce Momjian <maillist@candle.pha.pa.us>
Message-Id: <199910131831.OAA17018@candle.pha.pa.us>
Subject: Re: [HACKERS] Re: [DOCS] Outline for PostgreSQL book
In-Reply-To: <87u2nw8c6x.fsf@cenderis.demon.co.uk> from Bruce Stephens at "Oct
	12, 1999 11:08:05 pm"
To: Bruce Stephens <bruce@cenderis.demon.co.uk>
Date: Wed, 13 Oct 1999 14:31:54 -0400 (EDT)
CC: PostgreSQL-development <pgsql-hackers@postgreSQL.org>,
	PostgreSQL-documentation <docs@postgreSQL.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

> Bruce Momjian <maillist@candle.pha.pa.us> writes:
> 
> >                           PostgreSQL Book Proposal
> >                                       
> >                                Bruce Momjian
> 
> [...]
> 
> >    4.
> >           Advanced SQL Commands
> 
> [...]
> 
> 
> >    6.
> >           Interfacing to the POSTGRESQL Database
> >         (a)
> >                C Language API
> >         (b)
> >                Embedded C
> >         (c)
> >                C++
> >         (d)
> >                JAVA
> >         (e)
> >                ODBC
> >         (f)
> >                PERL
> >         (g)
> >                TCL/TK
> >         (h)
> >                PYTHON
> >         (i)
> >                Web access (PHP)
> >         (j)
> >                Server-side programming (PLPGSQL and SPI)
> 
> Isn't (j) logically part of chapter 4?  (Or 5, if it's PostgreSQL
> specific.)  Or am I completely confused?  (Where can I read about
> PLPGSQL and/or SPI, other than in the forthcoming book?)
> 
> If it came to a choice between having very short sections in chapter
> 6, and having two or three of them covered in more depth, I'd go for
> the latter.  

Not sure.  They are properly 'programming' to me, so I put them there. 
They address a similar programmatic need in the database.

> (Of course, you'll inevitably choose two or three which don't match
> what many readers will want (whichever two or three you choose), but
> even so, I think I'd get more out of a reasonably thorough coverage of
> a couple of languages that I won't use than superficial coverage of
> all of them which doesn't really reveal anything useful.)

I was going to do a newbie thing and show the advantages of each one. 
Not sure I want to go into great depth on any of them.  Just enough to
get people started, and using the documentation.

-- 
  Bruce Momjian                        |  http://www.op.net/~candle
  maillist@candle.pha.pa.us            |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026