As you might know, XMLDOCS documentation system contains bin/stattree script which parses complete Interchange source tree. Even though it really tries to recognize code regardless of formatting (much like Perl interpreter does), there are still some little suggestions on the programming style to make it easier for XMLDOCS.

DocBook! Interchange!