[mapserver-dev] typedef struct versus struct in mapserver.h

Even Rouault 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...
URL: <http://lists.osgeo.org/pipermail/mapserver-dev/attachments/20200525/dd3634db/attachment.html>

More information about the mapserver-dev mailing list