Re: documentation update for doc/src/sgml/func.sgml - Mailing list pgsql-hackers

From Michael Paquier
Subject Re: documentation update for doc/src/sgml/func.sgml
Date
Msg-id CAB7nPqSJuo-umKBftNO04nwGdomWwTPM0YDPJOrj9KdQKgASMw@mail.gmail.com
Whole thread Raw
In response to Re: documentation update for doc/src/sgml/func.sgml  (Andreas 'ads' Scherbaum <adsmail@wars-nicht.de>)
Responses Re: documentation update for doc/src/sgml/func.sgml  (Fabien COELHO <coelho@cri.ensmp.fr>)
List pgsql-hackers
On Sat, Oct 18, 2014 at 4:12 AM, Andreas 'ads' Scherbaum
<adsmail@wars-nicht.de> wrote:
> On 09/14/2014 06:32 PM, Peter Eisentraut wrote:
>>
>> On 9/12/14 3:13 PM, Andreas 'ads' Scherbaum wrote:
>>>
>>> Of course a general rule how to link to WP would be nice ...
>>
>>
>> I think Wikipedia links should be avoided altogether.  We can assume
>> that readers are technically proficient to look up general technical
>> concepts on their own using a reference system of their choice.
>>
>> In cases where a link is warranted, it is better to construct a proper
>> bibliographic citation to the primary source material, such as an IEEE
>> standard or an academic paper, in a way that will stand the test of time.
>
>
> That's a clear statement, and makes sense. Should be written down somewhere,
> so it can be found again.
>
>
>> Independent of that, it is actually not correct that "we use the IEEE's
>> rules", because "we" don't use any rules, that is up to the operating
>> system/platform.  While most platforms indeed do use the IEEE
>> floating-point standard more less, some don't.  Section 8.1.3 tries to
>> point that out.
>
>
> New version attached, WP link removed, wording changed.
Documentation format is still incorrect. The function names should be
put in a block <function>, same for the value 0.5 with <literal> and
the data types NUMERIC and REAL. Corrected patch is attached. The rest
looks fine to me, I am switching it to Ready for committer.
--
Michael

Attachment

pgsql-hackers by date:

Previous
From: Michael Paquier
Date:
Subject: Re: install libpq.dll in bin directory on Windows / Cygwin
Next
From: Tatsuo Ishii
Date:
Subject: Re: pgbench -f and vacuum