| From: | Bruce Momjian <bruce(at)momjian(dot)us> |
|---|---|
| To: | Robert Haas <robertmhaas(at)gmail(dot)com> |
| 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-06 23:44:23 |
| Message-ID: | 201102062344.p16NiNP25149@momjian.us |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
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?
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
| Attachment | Content-Type | Size |
|---|---|---|
| /rtmp/number.diff | text/x-diff | 11.3 KB |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Bruce Momjian | 2011-02-06 23:44:46 | pgsql: remove tags. |
| Previous Message | Andrew Dunstan | 2011-02-06 22:31:13 | pgsql: Force strings passed to and from plperl to be in UTF8 encoding. |