Missing documentation for postgis_transform_geometry

[janh]

The function "postgis_transform_geometry exists but is not documented. See here reasons for using it:

​http://lists.osgeo.org/pipermail/postgis-users/2013-February/036567.html

​http://postgis.17.n6.nabble.com/Removing-postgis-transform-geometry-td4363195.html

[robe]

I guess we can throw it in the exceptional functions category:

​http://postgis.net/docs/manual-2.0/reference.html#Exceptional_Functions

My fear with putting it along side ST_Transform and others is that users may get confused and use the wrong one. We can of course link to it from ST_Transform in the see Also and make mention of it.

[strk]

There's also a proposal to expose the functionality with an override of ST_Transform: ​https://github.com/postgis/postgis/pull/36

[dbaston]

I'd consider this to be a "private" function that's lacking a starting underscore. Since its functionality is exposed through ST_Transform (which is documented), it seems like it would be confusing to document this one.

[strk]

True since r14698 (2.3.0)

[robe]

So can we close this out then as a wontfix?

[dbaston]

+1

[strk]

I'd be ok to close this IFF the manual section about ST_Transform contains info about postgis_transform_geometry for use with older versions. So a 1.5 or 2.0 or 2.1 or 2.2 user would know how to do that kind of transform.

[robe]

Milestone renamed