Re: 'literal' for numbers - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: 'literal' for numbers
Date
Msg-id 201109051556.p85Fu3Q05428@momjian.us
Whole thread Raw
In response to 'literal' for numbers  (Bruce Momjian <bruce@momjian.us>)
List pgsql-docs
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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Use of literal in SGML docs
Next
From: Bruce Momjian
Date:
Subject: Re: Building PDFs error: \pdfendlink ended up in different nesting level than \pd