Introduce CPL_WARN_DEPRECATED and use it on some OGR functions/methods

git-svn-id: https://svn.osgeo.org/gdal/trunk@25450 f0d54148-0727-0410-94bb-9a71ac55c965