Hi folks, I was examining the doxygen generated API for some clues:
http://ci.apache.org/projects/trafficserver/trunk/doxygen/ when I stumbled across a couple of oddities. First off, this thing hasn't been regenerated since the beginning of this year. I have been focusing my attention on the Admin docs, so I didn't notice this - but I've already talked to Infra about it. Anyway, if you think that for our discussion here this isn't recent enough a version you can busy your machine for some 20 minutes to run make doxygen. In trunk I have added: EXCLUDE_PATTERNS = test_*.cc EXCLUDE_PATTERNS += test_*.h EXCLUDE_PATTERNS += test_*.i because I thought ``class Foo'' didn't really contribute to the understanding of our API or the server's functionality. Now, ignoring monstrosities like http://ci.apache.org/projects/trafficserver/trunk/doxygen/classContinuation.html the reason I'm writing are classes such as *Exception and *FatalClass: http://ci.apache.org/projects/trafficserver/trunk/doxygen/classFileStatException.html http://ci.apache.org/projects/trafficserver/trunk/doxygen/structMachineFatalClass.html Which aren't used anywhere in our code. Maybe my understanding here is wrong and they are made usable and are actually used by their existence alone? If not -- do we want to use them? What else is not used and could be removed? Or moved to attic? i -- Igor Galić Tel: +43 (0) 664 886 22 883 Mail: i.ga...@brainsware.org URL: http://brainsware.org/ GPG: 571B 8B8A FC97 266D BDA3 EF6F 43AD 80A4 5779 3257
