Re: 'literal' for numbers

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: 'literal' for numbers
Date: 2011-09-05 15:56:03
Message-ID: 201109051556.p85Fu3Q05428@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs pgsql-hackers

Bruce Momjian wrote:
> > So I guess I'm back agreeing with you. Basically, it seems like we
> > ought to use <literal> if it's being used as a value that the user
> > might want to supply (e.g. "if you set this parameter to 0, then no
> > statements will be logged). It shouldn't use <literal> if it's just
> > being used as a number (e.g. "this query will return all airplanes
> > with a height of less than 30,000 feet"). The cases I'm unsure about
> > are the ones where we're talking about a return value (e.g. in the
> > event of an error, this function will return -1).
>
> Robert, based on your logic, the 'return -1' should not be literal
> because no one would type that in. Unless I hear otherwise I will work
> on a patch to match the rules you outlined above.

FYI, here is what I thought was Robert's conclusion on this.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2011-09-05 15:59:22 Re: [COMMITTERS] pgsql: Clean up the #include mess a little.
Previous Message Bruce Momjian 2011-09-05 15:51:35 Use of literal in SGML docs

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2011-09-05 16:50:24 Re: Building PDFs error: \pdfendlink ended up in different nesting level than \pd
Previous Message Bruce Momjian 2011-09-05 15:51:35 Use of literal in SGML docs

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2011-09-05 15:56:34 Re: [GENERAL] pg_upgrade problem
Previous Message Bruce Momjian 2011-09-05 15:51:35 Use of literal in SGML docs