<html><head><style>body{font-family:Helvetica,Arial;font-size:13px}</style></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;"><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">The docs are just really old and haven’t be substantially touched in this area for ages, certainly not much since 2.0 when the wkb/wkt code got entirely replaced. So what you’re seeing is a need for a rewrite.</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">(1) “superset” means more than what’s in the early SFSQL standard, so the things in the ISO spec, and then things not even in that spec yet, like TRIANGLE and TIN and POLYHEDRAL SURFACE (though I guess now the SFSQL standard has mostly caught us up, object-wise).</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">(2) the old SFSQL version that had no 3d (1.1 from 1999)</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">(3) sentence probably dates from 1.5 or earlier, when the Z/M tags were not supported on WKT</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">(4) yep, Q&A probably post-dates the other sentence. </div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">Since the standards are themselves a hodgepodge, I think we should not worry so much about explicitly referencing chapter and verse about what standard each function or object or representation derives from, but rather be more clear about what the actual Current State of representations is, and scrub the docs a little more carefully for old information.</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;">P.</div><div id="bloop_customfont" style="font-family:Helvetica,Arial;font-size:13px; color: rgba(0,0,0,1.0); margin: 0px; line-height: auto;"><br></div><div id="bloop_sign_1386714891430611968" class="bloop_sign"><span style="font-family:helvetica,arial;font-size:13px"></span>-- <br>Paul Ramsey<br>http://cleverelephant.ca<div>http://postgis.net</div></div> <br><p style="color:#A0A0A8;">On December 10, 2013 at 4:43:26 PM, Mateusz Loskot (<a href="mailto://mateusz@loskot.net">mateusz@loskot.net</a>) wrote:</p> <blockquote type="cite" class="clean_bq"><span><div><div>Folks,<br><br>Recently, I have been reading through the recent OGC and SQL/MM,<br>sad me, and PostGIS docs, trying to understand things.<br><br>Apart from numerous confusing disjoint'ness between OGC and SQL/MM,<br>which I'm hopeless about getting clarified, I wonder if the PostGIS manual<br>could be updated to sound clearer on the standards the software supports.<br><br>For example, there are four parts which are unclear to me:<br><br>1) What does the superset mean in:<br><br>"""<br>4.1. GIS Objects<br>The GIS objects supported by PostGIS are a superset<br>"""<br><br>2) Which  version of OGC SFS does this "only support 2d" refer to?<br><br>"""<br>1.2. PostGIS EWKB, EWKT and Canonical Forms<br>OGC formats only support 2d geometries,<br>"""<br><br>3) What does this sentence actually mean?<br><br>"""<br>4.1.3. SQL-MM Part 3<br>The well-known text extensions are not yet fully supported.<br>"""<br><br>4) Doesn't the Q&A below stay in contradiction with the "only support<br>2d" in case 2) above?<br>    Or, what are the "extensions"?<br><br>"""<br>FAQ 3.5. What kind of geometric objects can I store?<br>You can store point, line, polygon, multipoint, multiline,<br>multipolygon, and geometrycollections (...) These are specified in the<br>Open GIS Well Known Text Format (with XYZ,XYM,XYZM extensions).<br>"""<br><br><br>Yet another example<br><br>"""<br>4.1.2. PostGIS EWKB, EWKT and Canonical Forms<br><br>OGC formats only support 2d geometries (...)<br>PostGIS extended formats are currently superset of OGC (...)<br><br>MULTICURVE( (0 0, 5 5), CIRCULARSTRING(4 0, 4 4, 8 4) )<br>"""<br><br>Now, given that the OGC SF 1.2+ specifies MultiCurve as an abstract type,<br>and SQL/MM makes it concrete, whichof the standards PostGIS EWKB/EWKT<br>actually extend here?<br><br>Basically, my question is, shouldn't the manual be more specific about<br>standard and version per feature?<br><br>If the answer is "No." and PostGIS stores/serves 'whatever' it is asked to,<br>leaving decisions such as about MultiCurve object is valid or not as<br>application-defined (PostGIS client decides) then please forget all my<br>questions.<br><br>I just would like to understand PostGIS position and strategy about it,<br>is that a documentation inaccuracy/lacking/error or a concious decision to<br>not to be too strict about that stuff.<br><br>Best regards,<br>-- <br>Mateusz  Łoskot, http://mateusz.loskot.net<br>_______________________________________________<br>postgis-devel mailing list<br>postgis-devel@lists.osgeo.org<br>http://lists.osgeo.org/cgi-bin/mailman/listinfo/postgis-devel</div></div></span></blockquote></body></html>