<html>
<head>
<base href="https://bugs.llvm.org/">
</head>
<body><table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Bug ID</th>
<td><a class="bz_bug_link
bz_status_NEW "
title="NEW - sphinx docs docs fail to compile with: "duplicate token description of SimpleValue, other instance in TableGen/LangRef""
href="https://bugs.llvm.org/show_bug.cgi?id=47062">47062</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>sphinx docs docs fail to compile with: "duplicate token description of SimpleValue, other instance in TableGen/LangRef"
</td>
</tr>
<tr>
<th>Product</th>
<td>Documentation
</td>
</tr>
<tr>
<th>Version</th>
<td>trunk
</td>
</tr>
<tr>
<th>Hardware</th>
<td>PC
</td>
</tr>
<tr>
<th>OS</th>
<td>Linux
</td>
</tr>
<tr>
<th>Status</th>
<td>NEW
</td>
</tr>
<tr>
<th>Severity</th>
<td>normal
</td>
</tr>
<tr>
<th>Priority</th>
<td>P
</td>
</tr>
<tr>
<th>Component</th>
<td>General docs
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>tmfinken@gmail.com
</td>
</tr>
<tr>
<th>CC</th>
<td>llvm-bugs@lists.llvm.org
</td>
</tr></table>
<p>
<div>
<pre>The llvm that sphinx documentation has some warnings, which are treated as
errors by default.
OS: Ubuntu 20.04..1
sphinx-build: 3.1.2
cmake: 3.16.3
##### By default, build will fail #####
$ mkdir build; cd build
$ cmake -DLLVM_ENABLE_SPHINX=true -DSPHINX_OUTPUT_HTML=true ../llvm/
...
$ make docs-llvm-html
...
/usr/local/lib/python3.8/dist-packages/recommonmark/parser.py:75: UserWarning:
Container node skipped: type=document
warn("Container node skipped: type={0}".format(mdnode.t))
...
Warning, treated as error:
/llvm/docs/TableGen/LangRef.rst:270:duplicate token description of SimpleValue,
other instance in TableGen/LangRef
##### Set "SPHINX_WARNINGS_AS_ERRORS=false" to allow build to continue #####
$ mkdir build; cd build
$ cmake -DLLVM_ENABLE_SPHINX=true -DSPHINX_OUTPUT_HTML=true
-DSPHINX_WARNINGS_AS_ERRORS=false ../llvm/
$ make docs-llvm-html
/usr/local/lib/python3.8/dist-packages/recommonmark/parser.py:75: UserWarning:
Container node skipped: type=document
warn("Container node skipped: type={0}".format(mdnode.t))
llvm/docs/TableGen/LangRef.rst:270: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:275: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:281: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:286: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:291: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:299: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:306: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:317: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
llvm/docs/TableGen/LangRef.rst:324: WARNING: duplicate token description of
SimpleValue, other instance in TableGen/LangRef
Snippet from "llvm/docs/TableGen/LangRef.rst":
===============================
.. productionlist::
SimpleValue: `TokInteger`
This represents the numeric value of the integer.
.. productionlist::
SimpleValue: `TokString`+
Multiple adjacent string literals are concatenated like in C/C++. The value
is the concatenation of the strings.
===============================
Possible related upstream Sphinx issue:
<a href="https://github.com/sphinx-doc/sphinx/issues/7427">https://github.com/sphinx-doc/sphinx/issues/7427</a>
At least as a short-term fix, SPHINX_WARNINGS_AS_ERRORS could default to false.</pre>
</div>
</p>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are on the CC list for the bug.</li>
</ul>
</body>
</html>