Re: [DOCS] SGML on functions

2010-08-29 Thread Thom Brown
On 29 August 2010 20:24, Thom Brown wrote: > On 29 August 2010 20:12, Peter Eisentraut wrote: >> On fre, 2010-08-27 at 21:57 +0100, Thom Brown wrote: >>> I've also noticed that a lot of the contents are indented as >>> part of the markup, but when output in HTML, each space it recreated >>> as i

Re: [DOCS] SGML on functions

2010-08-29 Thread Thom Brown
On 29 August 2010 20:12, Peter Eisentraut wrote: > On fre, 2010-08-27 at 21:57 +0100, Thom Brown wrote: >> I've also noticed that a lot of the contents are indented as >> part of the markup, but when output in HTML, each space it recreated >> as it ends up in either or tags. >> >> contents see

Re: [DOCS] SGML on functions

2010-08-29 Thread Peter Eisentraut
On fre, 2010-08-27 at 19:56 +0100, Thom Brown wrote: > E.g.: > > variance( class="parameter">expression) > > vs > > stddev_samp( class="parameter">expression) > > Which way is correct? "Correct" is a strong word in such matters, but I prefer the latter version. -- Sent via pgsql-docs mailin

Re: [DOCS] SGML on functions

2010-08-29 Thread Peter Eisentraut
On fre, 2010-08-27 at 21:57 +0100, Thom Brown wrote: > I've also noticed that a lot of the contents are indented as > part of the markup, but when output in HTML, each space it recreated > as it ends up in either or tags. > > contents seem to have been intentionally entered so > that they brea

Re: [DOCS] SGML on functions

2010-08-29 Thread Kevin Grittner
Thom Brown wrote: > Kevin Grittner wrote: >> You find examples like this: >> >> >> >> void qsort >>void *dataptr[] >>int left >>int right >>int (* comp) >> void *, void * >> >> >> > > But that page also says "Using FuncSynopsis for languages that are > unrelated to C

Re: [DOCS] SGML on functions

2010-08-29 Thread Thom Brown
On 29 August 2010 16:21, Kevin Grittner wrote: > Alvaro Herrera wrote: >> Excerpts from Thom Brown's message: > >>> variance(>> class="parameter">expression) >>> >>> vs >>> >>> stddev_samp(>> class="parameter">expression) >>> >>> Which way is correct? >> >> The latter I think -- see >> http://www

Re: [DOCS] SGML on functions

2010-08-29 Thread Kevin Grittner
Alvaro Herrera wrote: > Excerpts from Thom Brown's message: >> variance(> class="parameter">expression) >> >> vs >> >> stddev_samp(> class="parameter">expression) >> >> Which way is correct? > > The latter I think -- see > http://www.docbook.org/tdg/en/html/function.html > (but perhaps searc

Re: [DOCS] SGML on functions

2010-08-27 Thread Alvaro Herrera
Excerpts from Thom Brown's message of vie ago 27 14:56:04 -0400 2010: > Copied from another thread... > > Something I've noticed is an inconsistency in the SGML markup around > functions listed in tables. Sometimes the entire function signature > is considered to be the function, and other times

Re: [DOCS] SGML on functions

2010-08-27 Thread Thom Brown
On 27 August 2010 19:56, Thom Brown wrote: > Copied from another thread... > > Something I've noticed is an inconsistency in the SGML markup around > functions listed in tables.  Sometimes the entire function signature > is considered to be the function, and other times it's just the > function na

[DOCS] SGML on functions

2010-08-27 Thread Thom Brown
Copied from another thread... Something I've noticed is an inconsistency in the SGML markup around functions listed in tables. Sometimes the entire function signature is considered to be the function, and other times it's just the function name, with its parameters outside of the tags. E.g.: v