Hi Andrew: As of revision 12508 I have updated the doxygen documentation of PL_UNUSED function parameters to eliminate doxygen warnings for such parameters. The doxygen results for the annotations for such parameters look good now. However, there is still an issue in the detailed doxygen parameter listing with missing parentheses. For example,
PLINT PL_UNUSEDny rather than the desired PLINT PL_UNUSED( ny ) shows up in the detailed parameter listing for plFree2dGrid that appears in <$build_dir/doc/doxygen/html/pdfutils_8c.html>. However, I believe this issue is due to a doxygen bug since this issue does not occur for the brief form of the doxygen parameter listings that occur in that same html file. I also (revision 12509) fixed a misnamed parameter issue for the doxygen documentation of plcol1. If you attempt to build the doxygen documentation using the -DBUILD_DOX_DOC=ON cmake option and the build_doxygen target, the remaining warnings about our source code that are left after revision 12509 are in the following categories: Java warnings, e.g., /home/software/plplot_svn/HEAD/plplot_allura/bindings/java/PLCallbackCT.java:5: warning: Internal inconsistency: scope for class plplot::core::PLCallbackCT not found! wxwidgets C++ warnings, e.g., /home/software/plplot_svn/HEAD/plplot_allura/drivers/wxwidgets_agg.cpp:97: warning: documented function wxPLDevAGG::wxPLDevAGG' was not declared or defined. D warnings, e.g., /home/software/plplot_svn/HEAD/plplot_allura/bindings/d/plplot.d:18: warning: no matching class member found for alias void plplot::function(PLINT, PLFLT *, PLFLT *) moc_qt.cxx warnings, e.g., /home/software/plplot_svn/HEAD/build_dir/include/moc_qt.cxx:46: warning: documented function void MasterHandler::qt_static_metacall' was not declared or defined. Plframe.py warning, i.e., /home/software/plplot_svn/HEAD/plplot_allura/bindings/python/Plframe.py:455: warning: Unsupported xml/html tag <ButtonPress> found I don't believe I have the C++, D, etc., expertise to deal with these. Therefore, would you be willing to take a look before this release to see if any of these remaining doxygen warnings about our source code can be eliminated? Alan __________________________ Alan W. Irwin Astronomical research affiliation with Department of Physics and Astronomy, University of Victoria (astrowww.phys.uvic.ca). Programming affiliations with the FreeEOS equation-of-state implementation for stellar interiors (freeeos.sf.net); the Time Ephemerides project (timeephem.sf.net); PLplot scientific plotting software package (plplot.sf.net); the libLASi project (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project (lbproject.sf.net). __________________________ Linux-powered Science __________________________ ------------------------------------------------------------------------------ LIMITED TIME SALE - Full Year of Microsoft Training For Just $49.99! 1,500+ hours of tutorials including VisualStudio 2012, Windows 8, SharePoint 2013, SQL 2012, MVC 4, more. BEST VALUE: New Multi-Library Power Pack includes Mobile, Cloud, Java, and UX Design. Lowest price ever! Ends 9/20/13. http://pubads.g.doubleclick.net/gampad/clk?id=58041151&iu=/4140/ostg.clktrk _______________________________________________ Plplot-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/plplot-devel
