"Stephen McInerney" <[EMAIL PROTECTED]> wrote > My friend said the runtime efficiency of Doxygen on his build was > much > worse on the Python code than the C++ code, i.e. it took ages to > parse > the Python code. > > Anyone agree/disagree, or have any efficiency tips on how to > structure > things for decent Doxygen performance?
Until your post I had never heard of it. Having read the wiki article I gather its a Javadoc style documentation generator. Not being a fan of such beasts I doubt I'd be inclined to use it, but why is performamce an issue for a documentation generator? Presumably you only need to generate the documents periodically - say once a day - rather than with every build? In-code documentation is what is being used to create the docs so you can use that in day to day coding - one reason I find doc generators fairly useless! Documentation should be about what the comments don;t say not merely a comment and interface extraction. IMHO of course :-) Alan G. _______________________________________________ Tutor maillist - Tutor@python.org http://mail.python.org/mailman/listinfo/tutor
