<div dir="ltr">Thanks, Anand, for testing the script out. Glad to have some confirmation of it working.<div><br></div><div>Thanks, Roman, for uploading to ReadTheDocs and for your advice on building the docs.</div></div><div class="gmail_extra">

<br clear="all"><div><div><br></div><div>--</div><div>Sean Fisk</div></div>
<br><br><div class="gmail_quote">On Tue, Nov 26, 2013 at 5:34 AM, Gadiyar, Anand <span dir="ltr"><<a href="mailto:gadiyar@ti.com" target="_blank">gadiyar@ti.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">







<div lang="EN-US" link="blue" vlink="purple">
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Sean,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u>†<u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Thanks for this. Iíve just used your script on an Ubuntu box and it works well!<u></u><u></u></span></p>


<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u>†<u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">- Anand<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u>†<u></u></span></p>
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> pyside-bounces+gadiyar=<a href="mailto:ti.com@qt-project.org" target="_blank">ti.com@qt-project.org</a> [mailto:<a href="mailto:pyside-bounces%2Bgadiyar" target="_blank">pyside-bounces+gadiyar</a>=<a href="mailto:ti.com@qt-project.org" target="_blank">ti.com@qt-project.org</a>]
<b>On Behalf Of </b>Roman Lacko<br>
<b>Sent:</b> Tuesday, November 26, 2013 1:58 PM<br>
<b>To:</b> Sean Fisk<br>
<b>Cc:</b> PySide<br>
<b>Subject:</b> Re: [PySide] PySide 1.2.1 API Docs<u></u><u></u></span></p><div><div class="h5">
<p class="MsoNormal"><u></u>†<u></u></p>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">Hi Sean,<u></u><u></u></p>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">thanks for the hard work you spend on this.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">I will upload the docs to readthedocs server.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Thanks<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Roman<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u>†<u></u></p>
<div>
<p class="MsoNormal">2013/11/26 Sean Fisk <<a href="mailto:sean@seanfisk.com" target="_blank">sean@seanfisk.com</a>><u></u><u></u></p>
<div>
<div>
<p style="margin:0px!important">Hello PySiders!<u></u><u></u></p>
<p style="margin:0px!important">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
<a href="http://seanfisk.github.io/pyside-docs/" target="_blank">Github Pages</a> for use by the community. Iíve also created tarballs of the documentation available for download.<u></u><u></u></p>
<p style="margin:0px!important">Iíve gathered the build process into a Bash script which is available in
<a href="https://github.com/seanfisk/pyside-docs" target="_blank">this Github repo</a>. 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.<u></u><u></u></p>


<p style="margin:0px!important">During the build process, I stumbled upon a couple things:<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0mm">
<u></u><span style="font-size:10.0pt;font-family:Symbol"><span>∑<span style="font:7.0pt "Times New Roman"">††††††††
</span></span></span><u></u><code><span style="font-size:10.0pt;font-family:Consolas;border:solid #eaeaea 1.0pt;padding:0mm;background:#f8f8f8">qdoc3</span></code> 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
<code><span style="font-size:10.0pt;font-family:Consolas;border:solid #eaeaea 1.0pt;padding:0mm;background:#f8f8f8">qdoc3</span></code> to build correctly.<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0mm">
<u></u><span style="font-size:10.0pt;font-family:Symbol"><span>∑<span style="font:7.0pt "Times New Roman"">††††††††
</span></span></span><u></u>Shiboken has a documented <code><span style="font-size:10.0pt;font-family:Consolas;border:solid #eaeaea 1.0pt;padding:0mm;background:#f8f8f8">--documentation-only</span></code> 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.<u></u><u></u></p>
<p style="margin:0px!important">The documentation build process is little convoluted in general. Some of these issues seem like they are out of the hands of PySide, though.<u></u><u></u></p>
<p style="margin:0px!important">I hope these docs are able to help somebody out there!<u></u><u></u></p>
<p style="margin:0px!important">Thanks,<u></u><u></u></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal">--<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Sean Fisk<u></u><u></u></p>
</div>
</div>
</div>
</div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><br>
_______________________________________________<br>
PySide mailing list<br>
<a href="mailto:PySide@qt-project.org" target="_blank">PySide@qt-project.org</a><br>
<a href="http://lists.qt-project.org/mailman/listinfo/pyside" target="_blank">http://lists.qt-project.org/mailman/listinfo/pyside</a><u></u><u></u></p>
</div>
<p class="MsoNormal"><u></u>†<u></u></p>
</div>
</div>
</div></div></div>
</div>

</blockquote></div><br></div>