The doxygen-generated user documentation is poorly organized, due to the first-in, first-out nature of doxygen. The file docs/Doxyfile.in is a template which is processed and then used to create the Doxyfile ultimately used to generate documentation, when either --enable-doxygen or -DNETCDF_ENABLE_DOXYGEN are specified for autotools or cmake-based builds, respectively. We need to review the input files and decide on the appropriate order and organization for the input files in Doxyfle.in that result in an easier-to-parse, easier-to-read layout.
The doxygen-generated user documentation is poorly organized, due to the first-in, first-out nature of doxygen. The file
docs/Doxyfile.inis a template which is processed and then used to create theDoxyfileultimately used to generate documentation, when either--enable-doxygenor-DNETCDF_ENABLE_DOXYGENare specified for autotools or cmake-based builds, respectively. We need to review the input files and decide on the appropriate order and organization for the input files inDoxyfle.inthat result in an easier-to-parse, easier-to-read layout.