The .i files in this directory are generated files and should not be edited
manually.

1) cd $(GDAL_ROOT)/ogr
2) ( cat Doxyfile ; echo "GENERATE_XML=YES" ) | doxygen -

This will generate a $(GDAL_ROOT)/ogr/xml directory with the doc in XML form

3) cd $(GDAL_ROOT)/swig/python
4) make docs

This will parse $(GDAL_ROOT)/ogr/xml and regenerate $(GDAL_ROOT)/swig/include/python/docs