Re: BUG #6556: earthdistance module has lacking documentation

From: Gavin Flower <GavinFlower(at)archidevsys(dot)co(dot)nz>
To: Kasper Sandberg <kontakt(at)sandberg-consult(dot)dk>
Cc: Kevin Grittner <Kevin(dot)Grittner(at)wicourts(dot)gov>, pgsql-bugs(at)postgresql(dot)org
Subject: Re: BUG #6556: earthdistance module has lacking documentation
Date: 2012-03-29 09:55:10
Message-ID: 4F74317E.9030402@archidevsys.co.nz
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-bugs

On 29/03/12 12:36, Kasper Sandberg wrote:
> Yeah I will try provide a patch.
>
> I am not entirely certain how the wording should be, but I only
> understood that the cube based aproach is by default in meters after
> testing it out, though now of course it occurs to me that of course it
> is, given the math involved and that earth() is in meters, but i still
> feel that it should be pointed out that the cube based functions will,
> by default, due to earth() using meters, be in meters.
>
> I will sleep on it a day or two and suggest a patch.
>
> On 28/03/12 23:43, Kevin Grittner wrote:
>> <kontakt(at)sandberg-consult(dot)dk> wrote:
>>
>>> looking at
>>> http://www.postgresql.org/docs/9.1/static/earthdistance.html
>>>
>>> it looks very scarce and missing, and conflicting, some things
>>> operate based on miles, others meters. it also doesnt specify the
>>> units used for earth_distance() which seems to be meters.
>>
>> Any chance you could submit a patch to the source file?:
>>
>> doc/src/sgml/earthdistance.sgml
>>
>> ... or, barring that, suggest particular language at particular
>> line numbers in the source based on the gitweb page?:
>>
>> http://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=doc/src/sgml/earthdistance.sgml;h=f9002b235b83d8e2facd9164a66db46792f6e54a;hb=HEAD
>>
>>
>> -Kevin
>
>
Should be 'metres' not 'meters'! :-)

In response to

Browse pgsql-bugs by date

  From Date Subject
Next Message Robert Haas 2012-04-01 00:46:41 Re: Download not found for postgreSQL 9.1 for both SUSE and Red Hat on IBM Power (ppc)
Previous Message gcottenc 2012-03-29 07:36:22 BUG #6565: GEQO documentation discrepancy after 9.0 change?