Thread: sql.sgml take 3

sql.sgml take 3

From
"Robert B. Easter"
Date:
If anyone is paying attention to my patches in here, I have yet a third
version of this sql.sgml docs patch... another little fix and this one takes
the place of the previous two I sent.

I guess I should not send patches so often, but I worry that doing too much
work and not committing, that my work will be against an old version of the
file and will not patch right.  Oh well.  Reading the SQL spec and
interpretting the syntax is error prone.

--
-------- Robert B. Easter  reaster@comptechnews.com ---------
-- CompTechNews Message Board http://www.comptechnews.com/ --
-- CompTechServ Tech Services http://www.comptechserv.com/ --
---------- http://www.comptechnews.com/~reaster/ ------------



Attachment

Re: sql.sgml take 3

From
Peter Eisentraut
Date:
Robert B. Easter writes:

> If anyone is paying attention to my patches in here, I have yet a third
> version of this sql.sgml docs patch... another little fix and this one takes
> the place of the previous two I sent.

I was paying attention, but your patches are formatted so oddly that I
didn't have time to reformat them yet.  Indentation in SGML files is one
space, character data is indented as well, and there should not be tabs
anywhere.  The existing body of documentation is a pretty good example
there. ;-)

We could really use some of this stuff in the User's Guide, probably in
syntax.sgml, or in the Reference Manual (ref/select.sgml).  The Tutorial
is sort of a fifth order priority -- things don't really count as
documented if they are only shown there.  That is my fealing at least.

--
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/


Re: sql.sgml take 3

From
"Robert B. Easter"
Date:
I see what you are saying about the formatting.  I have starting using one
space indenting as you suggest.  It works fine.  I just had to tweak my
editor (kwrite) a little to make it more comfortable.

I'll see what I can do with the user's guide.  I'm working on some material
for it now but being very careful by checking it against the SQL standards
and what Postgres does (extensions/quirks).


On Tuesday 09 January 2001 12:21, Peter Eisentraut wrote:
> Robert B. Easter writes:
> > If anyone is paying attention to my patches in here, I have yet a third
> > version of this sql.sgml docs patch... another little fix and this one
> > takes the place of the previous two I sent.
>
> I was paying attention, but your patches are formatted so oddly that I
> didn't have time to reformat them yet.  Indentation in SGML files is one
> space, character data is indented as well, and there should not be tabs
> anywhere.  The existing body of documentation is a pretty good example
> there. ;-)
>
> We could really use some of this stuff in the User's Guide, probably in
> syntax.sgml, or in the Reference Manual (ref/select.sgml).  The Tutorial
> is sort of a fifth order priority -- things don't really count as
> documented if they are only shown there.  That is my fealing at least.

--
-------- Robert B. Easter  reaster@comptechnews.com ---------
-- CompTechNews Message Board http://www.comptechnews.com/ --
-- CompTechServ Tech Services http://www.comptechserv.com/ --
---------- http://www.comptechnews.com/~reaster/ ------------