Thanks, Anand, for testing the script out. Glad to have some confirmation of it working.
Thanks, Roman, for uploading to ReadTheDocs and for your advice on building the docs. -- Sean Fisk On Tue, Nov 26, 2013 at 5:34 AM, Gadiyar, Anand <[email protected]> wrote: > Sean, > > > > Thanks for this. I’ve just used your script on an Ubuntu box and it works > well! > > > > - Anand > > > > *From:* [email protected] [mailto: > [email protected]] *On Behalf Of *Roman Lacko > *Sent:* Tuesday, November 26, 2013 1:58 PM > *To:* Sean Fisk > *Cc:* PySide > *Subject:* Re: [PySide] PySide 1.2.1 API Docs > > > > Hi Sean, > > thanks for the hard work you spend on this. > > I will upload the docs to readthedocs server. > > Thanks > > Roman > > > > 2013/11/26 Sean Fisk <[email protected]> > > Hello PySiders! > > After a monumental struggle I was able to achieve the goal of building the > PySide and Shiboken 1.2.1 API docs. Following in the footsteps of those > before me, I’ve uploaded them to Github > Pages<http://seanfisk.github.io/pyside-docs/>for use by the community. I’ve > also created tarballs of the documentation > available for download. > > I’ve gathered the build process into a Bash script which is available in this > Github repo <https://github.com/seanfisk/pyside-docs>. I’ve tested it on > Mac OS X and CentOS, and it should work on most UNIX-like systems. If > anyone wants to hack on it, let me know if you have questions. > > During the build process, I stumbled upon a couple things: > > · qdoc3 from Qt 4.6 is needed to build API docs for PySide. This > is because WebXML support was buggy in Qt 4.7 and dropped in Qt 4.8, and > Shiboken uses this to generate the docs (thanks Roman Lacko). This is very > annoying because parts of Qt 4.6 must be configured and built for qdoc3to > build correctly. > > · Shiboken has a documented --documentation-only flag but refuses > to actually accept it. But Shiboken doesn’t tell you which option was > invalid, only that it was “called with the wrong arguments.” This is > annoying but seems like it has an easy fix. > > The documentation build process is little convoluted in general. Some of > these issues seem like they are out of the hands of PySide, though. > > I hope these docs are able to help somebody out there! > > Thanks, > > -- > > Sean Fisk > > > _______________________________________________ > PySide mailing list > [email protected] > http://lists.qt-project.org/mailman/listinfo/pyside > > >
_______________________________________________ PySide mailing list [email protected] http://lists.qt-project.org/mailman/listinfo/pyside
