<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=us-ascii"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
font-size:11.0pt;
font-family:"Calibri",sans-serif;
mso-fareast-language:EN-US;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
span.EpastaStils17
{mso-style-type:personal-compose;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;
mso-fareast-language:EN-US;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=LV link="#0563C1" vlink="#954F72" style='word-wrap:break-word'><div class=WordSection1><p class=MsoNormal>Hi all, newbie here.<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>I was going through the OpenGIS SFA spec and discovered some functions that are in the spec and implemented in PostGIS, but not documented in PostGIS docs. Before submitting any pull requests I wanted to check if these things are not intentionally undocumented (e.g. semi-deprecated).<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>Namely these are some aliases like ST_PolyFromText is implemented, but not documented. However, ST_PolygonFromText is documented, which seems to be implemented as an alias to ST_PolyFromText. Also a bunch of *FromWKB function, e.g. ST_PolygonFromWKB, ST_MLineFromWKB, ST_MPolyFromWKB… I noticed that these are listed in RFC03 as “PUBLIC KEEP” and thus they were intended to be documented and are mentioned in some older reference ( <a href="https://postgis.net/docs/manual-1.3/ch06.html">https://postgis.net/docs/manual-1.3/ch06.html</a> ), but I can’t find the status of that RFC and it’s from 2009 so the status of these functions might have changed since then anyways.<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>So could you give me a little guidance and tell if these functions should be documented?<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>--<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>One other detail that got me confused was the use of aliases in implementations. I was looking at these sources <a href="https://github.com/postgis/postgis/blob/master/postgis/postgis.sql.in">https://github.com/postgis/postgis/blob/master/postgis/postgis.sql.in</a> so please tell me if it’s the wrong file for implementations :) But my question is whether it is encouraged to use aliases or to NOT use aliases?<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>I am asking this because some functions like the aforementioned ST_PolygonFromText seem to be a straight up alias of ST_PolyFromText <a href="https://github.com/postgis/postgis/blob/master/postgis/postgis.sql.in#L5513">https://github.com/postgis/postgis/blob/master/postgis/postgis.sql.in#L5513</a><o:p></o:p></p><p class=MsoNormal>However ST_PolyFromWKB and ST_PolygonFromWKB appear to have identical implementations without referring to one another.<o:p></o:p></p><p class=MsoNormal>Which way is preferred? Or am I missing some detail?<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><p class=MsoNormal>Regards,<o:p></o:p></p><p class=MsoNormal>Juris<o:p></o:p></p></div></body></html>