Thread: BUG #6556: earthdistance module has lacking documentation
The following bug has been logged on the website: Bug reference: 6556 Logged by: Kasper Sandberg Email address: kontakt@sandberg-consult.dk PostgreSQL version: 9.1.3 Operating system: - Description:=20=20=20=20=20=20=20=20 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.
<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
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 -- Kasper Sandberg Sandberg Enterprises +45 51944242 http://www.sandbergenterprises.dk
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'! :-)