[llvm-bugs] [Bug 41789] New: lld documentation build fails with TemplateNotFound on Python 3.7/Sphinx 2.0.1

[via llvm-bugs]

https://bugs.llvm.org/show_bug.cgi?id=41789

            Bug ID: 41789
           Summary: lld documentation build fails with TemplateNotFound on
                    Python 3.7/Sphinx 2.0.1
           Product: lld
           Version: unspecified
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P
         Component: All Bugs
          Assignee: unassignedbugs at nondot.org
          Reporter: steven at uplinklabs.net
                CC: llvm-bugs at lists.llvm.org, peter.smith at linaro.org

Created attachment 21905
  --> https://bugs.llvm.org/attachment.cgi?id=21905&action=edit
output of sphinx-build with -v -v arguments

I'm trying to build the current release_80 branch of lld, but the build failed
around generating the Sphinx documentation:

-----
lld $ mkdir build; cd build
lld/build $ cmake -G Ninja .. -DLLVM_BUILD_DOCS=ON -DLLVM_ENABLE_SPHINX=ON
lld/build $ ninja docs/all
[1/1] Generating html Sphinx documentation for lld into
"/home/steven/lld-t/build/docs/html"
FAILED: docs/CMakeFiles/docs-lld-html 
cd /home/steven/lld-t/build/docs && /usr/bin/sphinx-build -b html -d
/home/steven/lld-t/build/docs/_doctrees-lld-html -q -W /home/steven/lld-t/docs
/home/steven/lld-t/build/docs/html

Theme error:
An error happened in rendering the page index.
Reason: TemplateNotFound()
ninja: build stopped: subcommand failed.
-----

I tried running sphinx-build without -q and with -v -v (output attached). It's
complaining about a missing template called "i", which strace shows it's trying
to access as well:

32385 stat("/usr/lib/python3.7/site-packages/sphinx/themes/basic/page.html",
{st_mode=S_IFREG|0644, st_size=273, ...}) = 0
32385 stat("/home/steven/lld-t/docs/_templates/layout.html",
{st_mode=S_IFREG|0644, st_size=305, ...}) = 0
32385 stat("/home/steven/lld-t/docs/llvm-theme/layout.html",
{st_mode=S_IFREG|0644, st_size=569, ...}) = 0
32385
stat("/usr/lib/python3.7/site-packages/sphinx/themes/basic/../basic/layout.html",
{st_mode=S_IFREG|0644, st_size=7811, ...}) = 0
32385 openat(AT_FDCWD, "/home/steven/lld-t/docs/_templates/i",
O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
32385 openat(AT_FDCWD, "/home/steven/lld-t/docs/llvm-theme/i",
O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
32385 openat(AT_FDCWD,
"/usr/lib/python3.7/site-packages/sphinx/themes/basic/i", O_RDONLY|O_CLOEXEC) =
-1 ENOENT (No such file or directory)
32385 openat(AT_FDCWD, "/home/steven/lld-t/docs/llvm-theme/../i",
O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
32385 openat(AT_FDCWD,
"/usr/lib/python3.7/site-packages/sphinx/themes/basic/../i",
O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)

If I run the Python 2.7 version of Sphinx, it builds without any errors. I note
that I have two different versions of Sphinx installed (1.8.5 for Python 2.7
and 2.0.1 for Pyton 3.7). Maybe a problem with Sphinx v2.0.x?

-- 
You are receiving this mail because:
You are on the CC list for the bug.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-bugs/attachments/20190507/2d0b1fce/attachment.html>