[swift-dev] Unable to build documentation using make command in docs directory

[Alex Hoppen]

This is a known issue. I filed a bug report for this some days ago (https://bugs.swift.org/browse/SR-620 <https://bugs.swift.org/browse/SR-620>). 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

easy_install Sphinx==1.3.4

- Alex

> On 07 Feb 2016, at 08:51, ankit goel via swift-dev <swift-dev at swift.org> wrote:
> 
> Hey,
> 
> 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:
> 
> On OS X:
> sphinx-build -b html -W -d _build/doctrees   . _build/html
> make: sphinx-build: No such file or directory
> make: *** [html] Error 1
> 
> On Ubuntu 14.04:
> /path/to/repo/swift-master/docs/ABI.rst:56 : WARNING: Could not parse literal_block as "swift". highlighting skipped
> 
> make: *** [html] Error 1
> 
> I would really appreciate if anyone can help me with generating docs. 
> 
> Ankit
> 
> _______________________________________________
> swift-dev mailing list
> swift-dev at swift.org
> https://lists.swift.org/mailman/listinfo/swift-dev

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-dev/attachments/20160207/f32ec9b7/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 3569 bytes
Desc: not available
URL: <https://lists.swift.org/pipermail/swift-dev/attachments/20160207/f32ec9b7/attachment.p7s>