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
- /rtmp/number.diff (text/x-diff) patch
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. +