> For example, I used to think that it would be a good idea to > document the tree form(s), but I now realize that the file tree.h is > exactly what is required.
Indeed. And we do try hard to make sure that the comments are updated when the contents are. That's why I'm not sure a big fan of these automated "documentation" generators. What's important is the *content*. And if the content is in the .h file, it can be read from there. If it isn't, or isn't up to date, then all these programs do is illustrate GIGO.
