Re: [HACKERS] New XML section for documentation

From: David Fetter <david(at)fetter(dot)org>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>, Peter Eisentraut <peter_e(at)gmx(dot)net>
Subject: Re: [HACKERS] New XML section for documentation
Date: 2006-08-26 15:04:48
Message-ID: 20060826150448.GJ11427@fetter.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Fri, Aug 25, 2006 at 08:37:19PM -0400, Bruce Momjian wrote:
> David Fetter wrote:
> > On Fri, Aug 25, 2006 at 07:46:57PM -0400, Bruce Momjian wrote:
> > > Here is an new XML section for our SGML documentation. It
> > > explains the various XML capabilities, if we support them, and
> > > how to use them.
> > >
> > > Comments?
> >
> > This looks hauntingly similar to Peter's presentation at the
>
> I used the XML/SQL and validation part from his talk, but the rest
> was from earlier email discussions.

Reuse is good :)

> > conference. :) I'd add a http://wiscorp.com/SQLStandards.html to the
>
> This seems to be the best URL, but it seems too detailed:
>
> http://wiscorp.com/H2-2005-197-SC32N1293-WG3_Presentation_for_SC32_20050418.pdf

I'd just put the http://wiscorp.com/SQLStandards.html URL in, as it
contains several references in varying levels of detail.

> > reference section.
> >
> > Speaking of other parts of the SQL:2003 standard, how about one
> > section each that mentions them? There's
> >
> > Part 4: SQL/PSM (Persistent Stored Modules)
> > Part 9: SQL/MED (Management of External Data) (my favorite)
> > Part 10: SQL/OLB (Object Language Binding)
> > Part 11: SQL/Schemata
> > Part 13: SQL/JRT (Java Routines and Types)
>
> I don't know anything about them.

We claim SQL standard compliance, so since those are part of SQL:2003,
we probably ought to mention them. SQL/PSM is a programming language
that lives inside the database, and DB2 and MySQL have it. SQL/MED
lets people talk to other data stores. SQL/OLB appears to be derived
from equel, which we have as ecpg. SQL/Schemata contains the
information schema. SQL/JRT appears to bear some similarity to
PL/Java and PL/J.

Cheers,
D
--
David Fetter <david(at)fetter(dot)org> http://fetter.org/
phone: +1 415 235 3778 AIM: dfetter666
Skype: davidfetter

Remember to vote!

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2006-08-26 16:20:49 Re: New XML section for documentation
Previous Message Nikolay Samokhvalov 2006-08-26 08:00:35 Re: New XML section for documentation

Browse pgsql-hackers by date

  From Date Subject
Next Message David Fetter 2006-08-26 15:06:55 Re: Tricky bugs in concurrent index build
Previous Message Andrew Dunstan 2006-08-26 14:53:45 Re: Coding style for emacs