Code quality news

[Sam Hartman]

>>>>> "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.