Code quality news

Sam Hartman 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 mailing list