From: | Robert Haas <robertmhaas(at)gmail(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us> |
Cc: | Fujii Masao <masao(dot)fujii(at)gmail(dot)com>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org> |
Subject: | Re: little mistakes in HS/SR |
Date: | 2011-02-07 05:14:25 |
Message-ID: | AANLkTim=gv47toLtHAJ04rfvDdcAN6HEbQ0nJK-FwFi_@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Sun, Feb 6, 2011 at 6:44 PM, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
> Robert Haas wrote:
>> On Thu, Jul 22, 2010 at 1:41 AM, Fujii Masao <masao(dot)fujii(at)gmail(dot)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.
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
From | Date | Subject | |
---|---|---|---|
Next Message | Robert Haas | 2011-02-07 05:16:27 | Re: How to make contrib/sepgsql on Ubuntu Maverick ? |
Previous Message | Hitoshi Harada | 2011-02-07 05:10:45 | Re: REVIEW: PL/Python table functions |