Karl Fogel wrote on Mon, 12 May 2008 at 15:11 -0400:
> Daniel Shahaf <d.s_at_daniel.shahaf.co.il> writes:
> > Oh, +1. Is there a way to share doxygen documentation between several
> > functions? Or shall I just repeat the description of the validations
> > performed, in each of the three docstrings?
>
> There's no way to share doxygen that I know of. Sometimes when two
> functions are very similar, we say "Like svn_foo(), but with an
> additional @a bar parameter that..." or something like that. So in this
> case, it would be fine to pick one API to document the canonical
> description of how validation happens, and then the others can say
> "Validate @a value the same way svn_repos_foo() does."
>
Thanks; see r31141.
Daniel
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe_at_subversion.tigris.org
For additional commands, e-mail: dev-help_at_subversion.tigris.org
Received on 2008-05-12 21:36:30 CEST