On Mon, Feb 14, 2011 at 02:12:15PM -0600, Chris Bagwell wrote: > On Sun, Feb 13, 2011 at 10:28 PM, Peter Hutterer > <peter.hutte...@who-t.net> wrote: > > Hi all, > > > > Just letting you know that after 0.10.11 I'll probably put a strict > > requirement on doxygen usage on every new function. > > No issues with me. I've not used documenting tools to date but its > readily available on my system. For libraries, I've always wanted to > explore it to auto generate the external API docs... but I guess that > doesn't apply here.
we can still generate the API docs, they're just a bit pointless since no-one interfaces with the driver :) which is also why I'm advocating documenting the code, not the header files because that is was people are looking at. > I'm sure we will struggle at first to find that comfortable level of > not having to document min() functions... but thats life. > (withholding comment on your color scheme. :-) ) it's beautiful :) (and the default, I'm too lazy to search for a different one) Cheers, Peter ------------------------------------------------------------------------------ The ultimate all-in-one performance toolkit: Intel(R) Parallel Studio XE: Pinpoint memory and threading errors before they happen. Find and fix more than 250 security defects in the development cycle. Locate bottlenecks in serial and parallel code that limit performance. http://p.sf.net/sfu/intel-dev2devfeb _______________________________________________ Linuxwacom-devel mailing list Linuxwacom-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linuxwacom-devel
