Re: [DOCS] Doc fixes and improvements
On 28 August 2010 15:29, Thom Brown wrote: > I attach a patch which fixes a few layout and markup issues, and also > a bit of tidying up. These include > - removing excessive table cells > - moving function parameters into function tags rather than having > them being considered separate > - adding return type column on XML2 contrib module functions list and > removing return types from function > - adding table header to XML2 contrib parameter table > Another minor fix attached to put text into a containing paragraph. -- Thom Brown Twitter: @darkixion IRC (freenode): dark_ixion Registered Linux user: #516935 diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index e6923c3..44063c3 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -82,8 +82,10 @@ NOT -SQL uses a three-valued Boolean logic where the null value represents -unknown. Observe the following truth tables: + + SQL uses a three-valued Boolean logic where the null value represents + unknown. Observe the following truth tables: + -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Doc fixes and improvements
On 28 August 2010 19:47, Thom Brown wrote: > On 28 August 2010 15:29, Thom Brown wrote: >> I attach a patch which fixes a few layout and markup issues, and also >> a bit of tidying up. These include >> - removing excessive table cells >> - moving function parameters into function tags rather than having >> them being considered separate >> - adding return type column on XML2 contrib module functions list and >> removing return types from function >> - adding table header to XML2 contrib parameter table >> > > Another minor fix attached to put text into a containing paragraph. > -- Apologies, ignore that last one. -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Doc fixes and improvements
On 28 August 2010 19:50, Thom Brown wrote: > On 28 August 2010 19:47, Thom Brown wrote: >> On 28 August 2010 15:29, Thom Brown wrote: >>> I attach a patch which fixes a few layout and markup issues, and also >>> a bit of tidying up. These include >>> - removing excessive table cells >>> - moving function parameters into function tags rather than having >>> them being considered separate >>> - adding return type column on XML2 contrib module functions list and >>> removing return types from function >>> - adding table header to XML2 contrib parameter table >>> >> >> Another minor fix attached to put text into a containing paragraph. >> -- > > Apologies, ignore that last one. > Okay, reattached and tested this time. diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index e6923c3..c27d743 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -51,125 +51,127 @@ The usual logical operators are available: + - - AND (operator) - - - - OR (operator) - + +AND (operator) + - - NOT (operator) - + +OR (operator) + - - conjunction - + +NOT (operator) + - - disjunction - + +conjunction + - - negation - + +disjunction + - - AND - OR - NOT - + +negation + + +AND +OR +NOT + + + SQL uses a three-valued Boolean logic where the null value represents unknown. Observe the following truth tables: + - - - - -a -b -a AND b -a OR b - - + + + + + a + b + a AND b + a OR b + + - - -TRUE -TRUE -TRUE -TRUE - + + + TRUE + TRUE + TRUE + TRUE + - -TRUE -FALSE -FALSE -TRUE - + + TRUE + FALSE + FALSE + TRUE + - -TRUE -NULL -NULL -TRUE - + + TRUE + NULL + NULL + TRUE + - -FALSE -FALSE -FALSE -FALSE - + + FALSE + FALSE + FALSE + FALSE + - -FALSE -NULL -FALSE -NULL - + + FALSE + NULL + FALSE + NULL + - -NULL -NULL -NULL -NULL - - - - + + NULL + NULL + NULL + NULL + + + + - - - - -a -NOT a - - + + + + + a + NOT a + + - - -TRUE -FALSE - + + + TRUE + FALSE + - -FALSE -TRUE - + + FALSE + TRUE + - -NULL -NULL - - - - - + + NULL + NULL + + + + The operators AND and OR are -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [pgsql-www] [DOCS] Example indenting
On 27 August 2010 20:23, Erik Rijkers wrote: http://www.flickr.com/photos/dark_ixion/4931878975/sizes/o/ > > FWIW, I like the changes to the tables, but I do dislike both boxes *and* > background-coloring of > both and (=code examples). To my eyes the changed font > is enough for both > and . > > OTOH, I mainly use the .pdf version of the documentation; and I suppose the > changes so far are all > CSS-only (i.e. no effect on the PDF)? > > sorry if I sound negative... > I don't think it will have any bearing on the PDF. Okay, I've made some more changes, and hopefully they're a bit more logical now. blue boxes - definitions grey boxes - examples, output etc red boxes - warnings, cautions yellow boxes - notes The yellow and red ones don't often occur, and the reason why I keep providing screenshots of the same page is because it's the only page in the documentation which contains one of each type of element. So here's the updated one: http://www.flickr.com/photos/dark_ixion/4935126375/sizes/o/ Unfortunately the tool I'm using to grab the whole page screenshot uses jpeg compression, but saves as PNG, which I then reduce the palette on to shrink the file size, so the colours are a bit off and the text looks a bit fuzzy. Are the boxes really that distracting? How about if I remove the border and just have a light background? The problem with relying on font difference is that it's not the same on every platform, hence why this all started. -- Thom Brown Twitter: @darkixion IRC (freenode): dark_ixion Registered Linux user: #516935 -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [pgsql-www] [DOCS] Example indenting
On 28 August 2010 20:53, Thom Brown wrote: > On 27 August 2010 20:23, Erik Rijkers wrote: > http://www.flickr.com/photos/dark_ixion/4931878975/sizes/o/ >> >> FWIW, I like the changes to the tables, but I do dislike both boxes *and* >> background-coloring of >> both and (=code examples). To my eyes the changed font >> is enough for both >> and . >> >> OTOH, I mainly use the .pdf version of the documentation; and I suppose the >> changes so far are all >> CSS-only (i.e. no effect on the PDF)? >> >> sorry if I sound negative... >> > > I don't think it will have any bearing on the PDF. > > Okay, I've made some more changes, and hopefully they're a bit more logical > now. > > blue boxes - definitions > grey boxes - examples, output etc > red boxes - warnings, cautions > yellow boxes - notes > > The yellow and red ones don't often occur, and the reason why I keep > providing screenshots of the same page is because it's the only page > in the documentation which contains one of each type of element. > > So here's the updated one: > http://www.flickr.com/photos/dark_ixion/4935126375/sizes/o/ > > Unfortunately the tool I'm using to grab the whole page screenshot > uses jpeg compression, but saves as PNG, which I then reduce the > palette on to shrink the file size, so the colours are a bit off and > the text looks a bit fuzzy. > > Are the boxes really that distracting? How about if I remove the > border and just have a light background? The problem with relying on > font difference is that it's not the same on every platform, hence why > this all started. > Modified without borders on boxes: http://www.flickr.com/photos/dark_ixion/4935194179/sizes/o/ -- Thom Brown Twitter: @darkixion IRC (freenode): dark_ixion Registered Linux user: #516935 -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
