Re: BUG #6556: earthdistance module has lacking documentation - Mailing list pgsql-bugs

From Gavin Flower
Subject Re: BUG #6556: earthdistance module has lacking documentation
Date
Msg-id 4F74317E.9030402@archidevsys.co.nz
Whole thread Raw
In response to Re: BUG #6556: earthdistance module has lacking documentation  (Kasper Sandberg <kontakt@sandberg-consult.dk>)
List 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@sandberg-consult.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'! :-)

pgsql-bugs by date:

Previous
From: Kasper Sandberg
Date:
Subject: Re: BUG #6556: earthdistance module has lacking documentation
Next
From: gcottenc@gmail.com
Date:
Subject: BUG #6565: GEQO documentation discrepancy after 9.0 change?