Re: Can synopsis (be made to) follow Python imports?
Vicki Brown <[email protected]>
| Newsgroups | gmane.comp.documentation.synopsis |
|---|---|
| Message-ID | <p0620070dbdee20f66c2f@[10.1.1.144]> |
Has anyone looked at Doxygen? http://www.stack.nl/~dimitri/doxygen/ THIS is what I want! I can run Doxygen at the top level of a program sourc tree and it will traverse the tree, read all of the fiiles and make up a VERY comprehensive set of browsable documentation. Wow. The only drawback is that, in order to make Doxygen work on Python, I have to cause it to run the source code through a filter that converts all of the Python source to pseudo-C++. The results are very much what I want to see. Extremely complete and extensive. But all of the source 'looks" like C++ :-( If not for that, Doxygen would be utterly perfect. If Synopsis would present the level of results available from Doxygen AND be language agnostic, it could be the killer app for source code documentation browsing. I wrote: I have (at my workplace) a set of Python source files that will become a single executable process. The code is made up of many .py files and assorted subdirectories. It is NOT a package. The "main" file imports 50 additional files which, in turn, import others. What I want to see is the source, classes, functions, etc for the entire executable program. Is there a way I can get this information from synopsis? I would find this functionality to be of great value. I think others would as well. -- - V. Vicki Brown <[email protected]> * Jabber: [email protected] Software Development Internal Technical Documentation http://www.cfcl.com/vlb/Jobweb/