[postgis-tickets] [PostGIS] #5483: Document ST_NumGeometries behaviour with empty geometries

[PostGIS]

#5483: Document ST_NumGeometries behaviour with empty geometries
----------------------------+---------------------------
  Reporter:  Mike Taves     |      Owner:  robe
      Type:  defect         |     Status:  closed
  Priority:  medium         |  Milestone:  PostGIS 3.4.1
 Component:  documentation  |    Version:  master
Resolution:  wontfix        |   Keywords:
----------------------------+---------------------------
Changes (by robe):

 * status:  new => closed
 * resolution:   => wontfix

Comment:

 It looks to be described to me.

 The ST_NumGeometries description says:

 https://postgis.net/docs/manual-3.4/ST_NumGeometries.html
 and

 https://postgis.net/docs/manual-dev/ST_NumGeometries.html

 The description says:

 "Returns the number of elements in a geometry collection
 (GEOMETRYCOLLECTION or MULTI*). For non-empty atomic geometries returns 1.
 For empty geometries returns 0. "

 I do notice it's not described on the short description on this page:

 https://postgis.net/docs/manual-dev/
 , which just says:

 "Returns the number of elements in a geometry collection"


 I feel like the added sentence on the front page to describe something
 people only accidentally use is not worth adding an additional sentence.
-- 
Ticket URL: <https://trac.osgeo.org/postgis/ticket/5483#comment:2>
PostGIS <http://trac.osgeo.org/postgis/>
The PostGIS Trac is used for bug, enhancement & task tracking, a user and developer wiki, and a view into the subversion code repository of PostGIS project.