[postgis-devel] [PostGIS] #300: Reference and comments for types

[PostGIS]

#300: Reference and comments for types
-------------------------+--------------------------------------------------
 Reporter:  mloskot      |       Owner:  pramsey
     Type:  enhancement  |      Status:  new    
 Priority:  medium       |   Milestone:         
Component:  postgis      |     Version:  trunk  
 Keywords:  manual,      |  
-------------------------+--------------------------------------------------
 I think that the
 [http://postgis.refractions.net/documentation/manual-1.4/ch07.html PostGIS
 Reference] could be completed with section called '''Types''' listing all
 data types defined by PostGIS and providing a short overview about it.

 Similarly as it is for functions. Actually, it would be naturally as the
 functions work on data :-)

 Next, these sections can feed comments (#35) so PostGIS types are nicely
 explained by PostgreSQL as it is done for native types
 {{{
 test=# \dT point
               List of data types
    Schema   | Name  |       Description
 ------------+-------+--------------------------
  pg_catalog | point | geometric point '(x, y)'
 (1 row)
 }}}

 but PostGIS types do not include description:

 {{{
 test=# \dT geometry
        List of data types
  Schema |   Name   | Description
 --------+----------+-------------
  public | geometry |
 (1 row)
 }}}

 I have attached a basic patch that presents the idea behind this proposal.

-- 
Ticket URL: <http://trac.osgeo.org/postgis/ticket/300>
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.