[swift-users] Swift 3.1 build error on MacOS Sierra v10.12.6

[Raj Barik]

​Hi,

I am trying to build swift-3.1-branch from github (https://github.com/apple/
swift) on my new Macbook Pro with OS Sierra v10.12.6. I get the following
error during doc generation using the command "sudo
./swift/utils/build-toolchain local-swift":

"""
[4193/4193] cd .../swift/docs && /usr/local/bin/sphinx-build -D
latex_paper_size=letter -d .../build/buildbot_osx/swift-macosx-x86_64/doctrees
-b html . .../build/buildbot_osx/swift-macosx-x86_64/docs/html
FAILED: docs/CMakeFiles/docs_html
cd .../swift/docs && /usr/local/bin/sphinx-build -D latex_paper_size=letter
-d .../build/buildbot_osx/swift-macosx-x86_64/doctrees -b html .
.../build/buildbot_osx/swift-macosx-x86_64/docs/html
Running Sphinx v1.6.3
WARNING: unknown config value 'latex_paper_size' in override, ignoring
....
generating indices... genindex
writing additional pages... LangRef
Exception occurred:
  File "/usr/local/lib/python2.7/site-packages/Sphinx-1.6.3-
py2.7.egg/sphinx/jinja2glue.py", line 200, in get_source
    raise TemplateNotFound(template)
TemplateNotFound: archive/LangRef.html
The full traceback has been saved in /tmp/sphinx-err-tlnjJ9.log, if you
want to report the issue to the developers.
Please also report this if it was a user error, so that a better error
message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-
doc/sphinx/issues>. Thanks!
ninja: build stopped: subcommand failed.
./utils/build-script: fatal error: command terminated with a non-zero exit
status 1, aborting
./utils/build-script: fatal error: command terminated with a non-zero exit
status 1, aborting
"""

With -W option enabled, the error was : "WARNING: unknown config value
'latex_paper_size' in override, ignoring". I do see that this variable is
set in CMakeLists.txt. I get the above error with -W enabled.
I have Sphinx 1.6.3 installed on my machine and Cmake 3.9.0

It seems like incompatible sphinx version? Has anyone seen this error with
latest code?

--Raj
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.swift.org/pipermail/swift-users/attachments/20170808/7cee90bf/attachment.html>