Code quality news
hartmans at MIT.EDU
Fri Jun 5 11:50:38 EDT 2009
>>>>> "Greg" == Greg Hudson <ghudson at MIT.EDU> writes:
Greg> It remains to be seen how well that can be enforced. Sam
Greg> observed that putting the doxygen markup in the krb5.hin
Greg> makes it more natural to document only the API contract. I
Greg> still favor putting doxygen markup in the implementation
Greg> (for the reasons I gave before), but it's a valid concern.
You confirmed that we can easily build API docs excluding all
references to the internal functions?
Also, what will the default be? I think it would be bad if a bunch of
functions started showing up in api docs with empty documentation
because the @internal marker was absent.
More information about the krbdev