[gdal-dev] Doxygen Arguments

[Andrew Bell]

Thanks to all who looked at this and Even for resolution.

On Thu, May 9, 2024 at 12:11 PM Even Rouault <even.rouault at spatialys.com>
wrote:

> Andrew,
>
> this is now fixed per
> https://github.com/OSGeo/gdal/commit/393eee77b40ae16751e4d2c0ad3e53386b22d025
> . Doxygen apparently takes the function/method at declaration time, and not
> definition time, and we had a number of unnamed parameters in declarations.
> (I also struggled with weird things when trying to fix that locally due not
> using a too recent Doxygen version. The HTML output was fine, but once
> integrated with Sphinx/Breathe, the parameters were still missing. Updating
> to Doxygen 1.9.8 as now used by our CI fixed things)
>
> Even
> Le 09/05/2024 à 15:20, Andrew Bell via gdal-dev a écrit :
>
> Hi,
>
> I'm looking at the documentation for GDALRasterBand::RasterIO and it's
> surprising that the names of the arguments aren't included in the function
> prototype despite them being in the doxygen function definition. The
> arguments are described well below the function prototype, making it hard
> to match things up and you have to assume that the order matches.
>
> Does some doxygen expert know how the argument names could somehow be
> included in the function prototype?
>
> Web page:
> https://gdal.org/api/gdalrasterband_cpp.html#classGDALRasterBand_1a75d4af97b3436a4e79d9759eedf89af4
>
> Source: https://fossies.org/linux/gdal/gcore/gdalrasterband.cpp (line 110)
>
> --
> Andrew Bell
> andrew.bell.ia at gmail.com
>
> _______________________________________________
> gdal-dev mailing listgdal-dev at lists.osgeo.orghttps://lists.osgeo.org/mailman/listinfo/gdal-dev
>
> -- http://www.spatialys.com
> My software is free, but my time generally not.
>
>

-- 
Andrew Bell
andrew.bell.ia at gmail.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/gdal-dev/attachments/20240509/1d3541b8/attachment-0001.htm>