On 1/27/06, David James <djames@collab.net> wrote:
> 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.
+1, I dislike decoration macros. They adds ambiguous.
--
Ivan Zhakov
Received on Fri Jan 27 08:13:57 2006