[postgis-devel] [PostGIS] #1994: Deprecate all functions with underscore_names rather than CamelCase

[PostGIS]

#1994: Deprecate all functions with underscore_names rather than CamelCase
---------------------+------------------------------------------------------
 Reporter:  strk     |       Owner:  pramsey      
     Type:  task     |      Status:  new          
 Priority:  medium   |   Milestone:  PostGIS 2.1.0
Component:  postgis  |     Version:  trunk        
 Keywords:           |  
---------------------+------------------------------------------------------

Comment(by robe):

 policy. I don't think we have an official one, though we should have one.

 My policy anyway:

 1) Add new signature
 2) Mark old signature as deprecated in SQL
 3) We completely drop the documentation of old signature so that new users
 don't know it ever existed and old users won't see descriptions next to
 the function so they should get the hint hopefully not to use it
 4) Drop testing old signature and replace with new signature
 5) in 1-2 years later, move the deprecated functions to the legacy file
 unless we feel these functions were so stupid or new that it is not likely
 anyone used them.  In that case we move them right away before anyone
 starts using them.

 I think though that all the above are probably in use so follow the 1-2
 year rule. ESPECIALLY the linear referencing ones.

 The ST_Mem_Size, ST_Point_Inside_Circle, ST_Shift_Longitude (iffy since
 it's new but probably a somewhat popular function for those who have to
 deal with google/bing map stuff) you might be able to get away with moving
 into the legacy file now.

-- 
Ticket URL: <http://trac.osgeo.org/postgis/ticket/1994#comment:4>
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.