[mapserver-dev] typedef struct versus struct in mapserver.h
even.rouault at spatialys.com
Mon May 25 14:05:21 PDT 2020
> The advantage of the SWIG docstrings is they can then be read from the
> Python source and then Sphinx can take over allowing internal doc links,
> inclusion of text, images, examples on a class by class basis.
Sure. But if SWIG can import Doxygen, that could perhaps serve the same purpose? (Using
SWIG directly is ... well ... a particular experience)
While in brainstorming mode, one thing I wanted to mention is that we do use on GDAL and
PROJ is Doxygen and import it in Sphinx, through the Breathe extension of Sphinx. But we do
that just for documenting our C/C++ API.
Things like https://gdal.org/api/raster_c_api.html or
https://proj.org/development/reference/cpp/crs.html are generated from that.
Relevant entry points for GDAL:
- create Doxygen XML output:
- declare Breathe extension in Sphinx configuration:
- use part of the generated Doxygen doc:
Similar technics on PROJ.
That works pretty well. Occasionally we've hit some bugs on the Breathe/Sphinx side though.
But we haven't used that to create a documentation of the Python API
Spatialys - Geospatial professional services
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the mapserver-dev