Re: little mistakes in HS/SR - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: little mistakes in HS/SR
Date
Msg-id 201102071455.p17EtN222432@momjian.us
Whole thread Raw
In response to Re: little mistakes in HS/SR  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-hackers
Robert Haas wrote:
> On Sun, Feb 6, 2011 at 6:44 PM, Bruce Momjian <bruce@momjian.us> wrote:
> > 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?
> 
> I am doubtful that this makes sense in general.  I suspect it depends
> somewhat on context.

We do spell out "zero" in a few cases where it makes sense, so it seems
we need no change here.

--  Bruce Momjian  <bruce@momjian.us>        http://momjian.us EnterpriseDB
http://enterprisedb.com
 + It's impossible for everything to be true. +


pgsql-hackers by date:

Previous
From: Robert Haas
Date:
Subject: Re: Sync Rep for 2011CF1
Next
From: Nicolas Grilly
Date:
Subject: Re: [GENERAL] Why "copy ... from stdio" does not return immediately when reading invalid data?