Re: [Graphviz] building doc with Python3
Robin Dunn <[email protected]>
| Newsgroups | gmane.comp.python.wxpython.devel |
|---|---|
| Message-ID | <[email protected]> |
[email protected] wrote: > I still go on to build the doc (with 'python3 ./build.py dox etg > sphinx). And I don't forget to run 'cleanall'. > > There is a problem I don't understand. > The etg command run etg/htmlwin.py. And this py cause a lot of trouble. > > The file > "Phoenix/ext/wxWidgets/docs/doxygen/out/xml/wxHtmlLinkEvent" > doesn't exists. Don't know why or if it is needed. > It's telling you that it can't find the XML files containing the definitions of the wxHtmlLinkEvent class. There are actually a few files that it will check for. I'll push a change that prints the list of files that are looked for when none are found, and also raises an exception if none are found. It may be that you just need to run the dox step again, or if doxygen has changed how they name those files in newer versions then it may need a change to how it builds filenames to look for. If so, the exception will show you where that is. I would have expected it to fail a lot earlier than wxHtmlLinkEvent however if that was the case. > I modified the code, so that the script goes on and just put out a > message about it. > > Then htmlwin.py call a lot of ClassDef.find(). And of course it find > nothing. And find() raises exceptions. > > So what should be done? > > There is one class missing (don't know why) and the complete build > script crash against the wall. I think this behavior is to much. > There could be warnings or errors and then the script should go on. > > What do you think? There are too many cases where if something is missing or broken that many other things will be broken too, so I think that failing is the right thing to do. You wouldn't expect a programming language to just ignore syntax errors and continue on as if that code wasn't present. -- Robin Dunn Software Craftsman http://wxPython.org -- You received this message because you are subscribed to the Google Groups "wxPython-dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.