On 1/26/06, Branko Èibej <brane@xbc.nu> wrote:
> >>> 2. SVN_NO_IGNORE(svn_error_t *)
> >>> function_name(param one,
> >>> param two);
[...]
> Before anyone starts doing this, please consider:
>
> * What happens to the generated API documentation
> * Can we conceivably do this with an attribute on svn_error_t
> instead of every function that returns it
>
> Whatever you decide to do, the generated docs have to remain clean (that
> is, there should be no trace of such obfuscation^Wdecoration in the docs).
Here's an alternative proposal: Instead of adding attributes to each
function manually, we could write a script which adds and removes the
attributes on demand. If folks want to test for deprecated functions,
unchecked errors, or other problems, they can use this script. The
script would work like lint. We could even integrate this script into
our test suite, if we want.
Cheers,
David
--
David James -- http://www.cs.toronto.edu/~james
Received on Fri Jan 27 08:00:37 2006