Re: little mistakes in HS/SR

Bruce Momjian <bruce@momjian.us>

From: Bruce Momjian <bruce@momjian.us>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Fujii Masao <masao.fujii@gmail.com>, PostgreSQL-development <pgsql-hackers@postgresql.org>
Date: 2011-02-06T23:44:23Z
Lists: pgsql-hackers

Attachments

Robert Haas wrote:
> On Thu, Jul 22, 2010 at 1:41 AM, Fujii Masao <masao.fujii@gmail.com> wrote:
> > We should enclose -1 with <literal> tag.
> 
> A quick survey of the documentation as a whole suggests that we
> enclose -1 with <literal> in a few places but more commonly we don't.
> I have no position on whether we should do it or not, but maybe we
> should try to be consistent throughout the docs?  Or at least have a
> consistent rule for deciding what to do in a particular case?

Excellent question.  I went through the documentation and removed
<literal> tags where appropriate --- there are cases where we are
referencing an actual number, and there <literal> makes sense.  Applied
patch attached.

I think the larger question is whether we should say "zero" for 0 and
"one" for 1, etc.  Prose typography suggests we should, but for
technical manuals, I am not sure.  Ideas?

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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