<div dir="ltr">Thanks Alex, This fixed the issue on ubuntu 14.04.<div><br></div><div>However, I am still unable to compile docs on OS X even when I use Sphinx 1.3.4</div><div><br></div><div>I get the following error:</div><div><p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">sphinx-build -b html -W -d _build/doctrees   . _build/html</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">Traceback (most recent call last):</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/usr/local/bin/sphinx-build&quot;, line 11, in &lt;module&gt;</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    sys.exit(main())</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/Library/Python/2.7/site-packages/sphinx/__init__.py&quot;, line 51, in main</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    sys.exit(build_main(argv))</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/Library/Python/2.7/site-packages/sphinx/__init__.py&quot;, line 61, in build_main</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    from sphinx import cmdline</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/Library/Python/2.7/site-packages/sphinx/cmdline.py&quot;, line 19, in &lt;module&gt;</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    from docutils.utils import SystemMessage</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/Library/Python/2.7/site-packages/docutils-0.12-py2.7.egg/docutils/utils/__init__.py&quot;, line 20, in &lt;module&gt;</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    import <a href="http://docutils.io">docutils.io</a></font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/Library/Python/2.7/site-packages/docutils-0.12-py2.7.egg/docutils/io.py&quot;, line 18, in &lt;module&gt;</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    from docutils.utils.error_reporting import locale_encoding, ErrorString, ErrorOutput</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/Library/Python/2.7/site-packages/docutils-0.12-py2.7.egg/docutils/utils/error_reporting.py&quot;, line 47, in &lt;module&gt;</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    locale_encoding = locale.getlocale()[1] or locale.getdefaultlocale()[1]</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/locale.py&quot;, line 543, in getdefaultlocale</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    return _parse_localename(localename)</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">  File &quot;/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/locale.py&quot;, line 475, in _parse_localename</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">    raise ValueError, &#39;unknown locale: %s&#39; % localename</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">ValueError: unknown locale: UTF-8</font></span></p>
<p style="margin:0px;font-size:12px;line-height:normal;font-family:&#39;Andale Mono&#39;"><span style="background-color:rgb(255,255,255)"><font color="#000000">make: *** [html] Error 1</font></span></p></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Feb 7, 2016 at 1:28 PM, Alex Hoppen <span dir="ltr">&lt;<a href="mailto:alex@ateamer.de" target="_blank">alex@ateamer.de</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word">This is a known issue. I filed a bug report for this some days ago (<a href="https://bugs.swift.org/browse/SR-620" target="_blank">https://bugs.swift.org/browse/SR-620</a>). It is an incompatibility between the Swift documentation and Sphinx 1.3.5. You can get around the issue by installing Sphinx 1.3.4 temporarily using<div><br></div><div>easy_install Sphinx==1.3.4</div><div><br></div><div>- Alex</div><div><br></div><div><blockquote type="cite"><div><div class="h5"><div>On 07 Feb 2016, at 08:51, ankit goel via swift-dev &lt;<a href="mailto:swift-dev@swift.org" target="_blank">swift-dev@swift.org</a>&gt; wrote:</div><br></div></div><div><div><div class="h5"><div dir="ltr"><font face="arial, helvetica, sans-serif">Hey,</font><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif">After downloading the swift repository, I am unable to generate html files from rst files in docs directory.  I have installed Sphinx and tried this on both OS X and ubuntu 14.04. When I run the make command in docs directory I get the following error:</font></div><div><font face="arial, helvetica, sans-serif"><br></font></div><div><font face="arial, helvetica, sans-serif">On OS X:</font></div><div><div style="margin:0px;font-size:12px;line-height:normal"><span style="background-color:rgb(255,255,255)"><font face="arial, helvetica, sans-serif">sphinx-build -b html -W -d _build/doctrees   . _build/html</font></span></div><div style="margin:0px;font-size:12px;line-height:normal"><span style="background-color:rgb(255,255,255)"><font face="arial, helvetica, sans-serif">make: sphinx-build: No such file or directory</font></span></div><div style="margin:0px;font-size:12px;line-height:normal"><span style="background-color:rgb(255,255,255)"><font face="arial, helvetica, sans-serif">make: *** [html] Error 1</font></span></div><div style="margin:0px;font-size:12px;line-height:normal"><span style="background-color:rgb(255,255,255)"><font face="arial, helvetica, sans-serif"><br></font></span></div><div style="margin:0px;font-size:12px;line-height:normal"><span style="font-family:arial,helvetica,sans-serif;font-size:small">On Ubuntu 14.04</span><span style="font-family:arial,helvetica,sans-serif;font-size:small">:</span><br></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif">/path/to/repo/swift-master/docs/ABI.rst:56 : WARNING: Could not parse literal_block as &quot;swift&quot;. highlighting skipped</font></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif"><br></font></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif">make: *** [html] Error 1</font></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif"><br></font></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif">I would really appreciate if anyone can help me with generating docs. </font></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif"><br></font></div><div style="margin:0px;line-height:normal"><font face="arial, helvetica, sans-serif">Ankit</font></div><div style="margin:0px;line-height:normal"><br></div></div></div></div></div>
_______________________________________________<br>swift-dev mailing list<br><a href="mailto:swift-dev@swift.org" target="_blank">swift-dev@swift.org</a><br><a href="https://lists.swift.org/mailman/listinfo/swift-dev" target="_blank">https://lists.swift.org/mailman/listinfo/swift-dev</a><br></div></blockquote></div><br></div></blockquote></div><br></div>