[postgis-tickets] [PostGIS] #4371: Use consistent verb form in one-line function descriptions

PostGIS trac at osgeo.org
Sat Aug 10 16:04:36 PDT 2019


#4371: Use consistent verb form in one-line function descriptions
----------------------+---------------------------
  Reporter:  dbaston  |      Owner:  pramsey
      Type:  defect   |     Status:  new
  Priority:  low      |  Milestone:  PostGIS 3.0.0
 Component:  postgis  |    Version:  2.4.x
Resolution:           |   Keywords:
----------------------+---------------------------

Comment (by mdavis):

 Dan, any preference for which verb form to use?

 I did a very brief scan of other docs, but the results are inconclusive.
 The OGC SFS 99-049 uses "Returns", while the Postgres documentation seems
 to mostly use "Return" (e.g. see the [https://www.postgresql.org/docs/11
 /functions-string.html string functions doc]).

 My leaning is towards "Returns" etc.

-- 
Ticket URL: <https://trac.osgeo.org/postgis/ticket/4371#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.


More information about the postgis-tickets mailing list