> The biggest advantage of using > source comments is that there is a much better chance that the > documentation will be updated and kept in sync with the actual code. I agree with Ted. I must admit that I do not use anything like doxygen myself but if it would be adopted for OpenAFS I would have a reason to learn how to use the stuff ;-) Harald.