<div dir="ltr"><div>The policy for the required versions I think is whatever is installed on the build bots. I've run into several problems with this in the past (see <a href="http://lists.llvm.org/pipermail/llvm-dev/2019-June/133038.html">http://lists.llvm.org/pipermail/llvm-dev/2019-June/133038.html</a> for details). Unless they've been updated since, the version you should try is sphinx v 1.7.5 and recommonmark v 0.4.0.</div><div><br></div><div>James<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, 19 Dec 2019 at 09:06, Nicolai Hähnle via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org">llvm-dev@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Leonardo,<br>
<br>
I can't reproduce this with sphinx 1.8.5 and recommonmark 0.8.15.<br>
What's the policy on minimum required tools versions?<br>
<br>
Cheers,<br>
Nicolai<br>
<br>
On Tue, Dec 17, 2019 at 8:49 PM Sandoval Gonzalez, Leonardo via<br>
llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>> wrote:<br>
><br>
> Hi<br>
><br>
> I am trying to build  the documentation and view it as html. When I ran<br>
> the `make docs-llvm-html` target but ran into this below issue. Has<br>
> anyone faced this issue?<br>
><br>
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------<br>
><br>
> % make docs-llvm-html -j3<br>
> Generating html Sphinx documentation for llvm into<br>
> "/home/lsandov1/repos/llvm-project/build/docs/html"<br>
> /home/lsandov1/.local/lib/python2.7/site-packages/recommonmark/parser.py:75:<br>
> UserWarning: Container node skipped: type=document<br>
>    warn("Container node skipped: type={0}".format(mdnode.t))<br>
><br>
> Warning, treated as error:<br>
> /home/lsandov1/repos/llvm-project/llvm/docs/AMDGPUUsage.rst:1317: ERROR:<br>
> Malformed table.<br>
> Column span alignment problem in table line 10.<br>
><br>
> ================= ============== ========= ================================<br>
> String Key        Value Type     Required? Description<br>
> ================= ============== ========= ================================<br>
> "Name"            string                   Kernel argument name.<br>
> "TypeName"        string                   Kernel argument type name.<br>
> "Size"            integer        Required  Kernel argument size in bytes.<br>
> "Align"           integer        Required  Kernel argument alignment in<br>
>                                             bytes. Must be a power of two.<br>
> "ValueKind"       string         Required  Kernel argument kind that<br>
><br>
> ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------<br>
><br>
> SW versions:<br>
><br>
> OS: NAME="Ubuntu" VERSION="16.04.6 LTS (Xenial Xerus)"<br>
><br>
> sphinx: '1.3.6'<br>
><br>
> recommonmark: 0.6.0<br>
><br>
> Thanks for your help.<br>
><br>
><br>
> lsg<br>
><br>
><br>
><br>
> _______________________________________________<br>
> LLVM Developers mailing list<br>
> <a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a><br>
> <a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
<br>
<br>
<br>
-- <br>
Lerne, wie die Welt wirklich ist,<br>
aber vergiss niemals, wie sie sein sollte.<br>
_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a><br>
<a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
</blockquote></div>