On Sun, Mar 16, 2008 at 08:39:53PM -0700, Darren New wrote:
Granted, it doesn't have to be bad. But in my experience, any library that gives you *only* auto-extracted documentation has suckalicious documentation. Anyone doing serious development for useful libraries does the documentation first, and something winds up without a good place to put it in the code.
I don't think it is possible to write meaningful documentation for non-trivial and non-redundant code before the code has been written. We like to maintain an illusion that things can work this way, but they don't. You can document the library this way the second time you write it, perhaps. David -- [email protected] http://www.kernel-panic.org/cgi-bin/mailman/listinfo/kplug-lpsg
