Thread: sql.sgml take 3
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
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/
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/ ------------