2012/9/16 Pete Batard <p...@akeo.ie>:
> First, thanks go to Ludovic for the help on doxygen. Much appreciated. I
> picked all of your suggestions, except for WARN_NO_PARAMDOC, as I think
> I'd still prefer to get a warning about parameters we forget to document.

# This WARN_NO_PARAMDOC option can be abled to get warnings for
# functions that are documented, but have no documentation for their parameters
# or return value. If set to NO (the default) doxygen will only warn about
# wrong or incomplete parameter documentation, but not about the absence of
# documentation.

The default value is NO (and is used by libusbx). That is that Doxygen
will NOT warn about the _abscence_ of documentation.

If the value is NO then Doxygen would warn if some parameters are not
documented.
If the value is YES then Doxygen would _also_ warn if no parameters is
documented.

Using YES will warm in more cases. I think that is what we (should) want.

Bye

-- 
 Dr. Ludovic Rousseau

------------------------------------------------------------------------------
Everyone hates slow websites. So do we.
Make your web apps faster with AppDynamics
Download AppDynamics Lite for free today:
http://ad.doubleclick.net/clk;258768047;13503038;j?
http://info.appdynamics.com/FreeJavaPerformanceDownload.html
_______________________________________________
libusbx-devel mailing list
libusbx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/libusbx-devel

Reply via email to