<div dir="ltr"><div>It looks like Doxygen is using argument names from the function prototype instead of the implementation:</div><div><a href="https://github.com/OSGeo/gdal/blob/master/gcore/gdal_priv.h#L753">https://github.com/OSGeo/gdal/blob/master/gcore/gdal_priv.h#L753</a></div><div><br></div><div>I did some searching but didn't come across a way to change this behavior. It looks like many other functions include the argument names in the prototype, so maybe RasterIO should be updated to include them too?<br></div><div><br></div><div>Dan<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, May 9, 2024 at 9:20 AM Andrew Bell via gdal-dev <<a href="mailto:gdal-dev@lists.osgeo.org">gdal-dev@lists.osgeo.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi,<div><br></div><div>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.<br><br><div>Does some doxygen expert know how the argument names could somehow be included in the function prototype?<br><br>Web page: <a href="https://gdal.org/api/gdalrasterband_cpp.html#classGDALRasterBand_1a75d4af97b3436a4e79d9759eedf89af4" target="_blank">https://gdal.org/api/gdalrasterband_cpp.html#classGDALRasterBand_1a75d4af97b3436a4e79d9759eedf89af4</a><br><br>Source: <a href="https://fossies.org/linux/gdal/gcore/gdalrasterband.cpp" target="_blank">https://fossies.org/linux/gdal/gcore/gdalrasterband.cpp</a> (line 110)</div><div><br>--<br></div><div dir="ltr" class="gmail_signature">Andrew Bell<br><a href="mailto:andrew.bell.ia@gmail.com" target="_blank">andrew.bell.ia@gmail.com</a></div></div></div>
_______________________________________________<br>
gdal-dev mailing list<br>
<a href="mailto:gdal-dev@lists.osgeo.org" target="_blank">gdal-dev@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/gdal-dev" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/gdal-dev</a><br>
</blockquote></div>