[llvm-dev] llvm/docs/AMDGPUUsage.rst ERROR: Malformed table

James Henderson via llvm-dev
Thu, 19 Dec 2019 09:55:10 -0000

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
http://lists.llvm.org/pipermail/llvm-dev/2019-June/133038.html 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.

James

On Thu, 19 Dec 2019 at 09:06, Nicolai Hähnle via llvm-dev <
llvm-dev at lists.llvm.org> wrote:

> Hi Leonardo,
>
> I can't reproduce this with sphinx 1.8.5 and recommonmark 0.8.15.
> What's the policy on minimum required tools versions?
>
> Cheers,
> Nicolai
>
> On Tue, Dec 17, 2019 at 8:49 PM Sandoval Gonzalez, Leonardo via
> llvm-dev <llvm-dev at lists.llvm.org> wrote:
> >
> > Hi
> >
> > I am trying to build  the documentation and view it as html. When I
ran
> > the `make docs-llvm-html` target but ran into this below issue. Has
> > anyone faced this issue?
> >
> >
>
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
> >
> > % make docs-llvm-html -j3
> > Generating html Sphinx documentation for llvm into
> > "/home/lsandov1/repos/llvm-project/build/docs/html"
> >
>
/home/lsandov1/.local/lib/python2.7/site-packages/recommonmark/parser.py:75:
> > UserWarning: Container node skipped: type=document
> >    warn("Container node skipped: type={0}".format(mdnode.t))
> >
> > Warning, treated as error:
> > /home/lsandov1/repos/llvm-project/llvm/docs/AMDGPUUsage.rst:1317:
ERROR:
> > Malformed table.
> > Column span alignment problem in table line 10.
> >
> > ================= ============== ========>
===============================> > String Key        Value Type
Required? Description
> > ================= ============== ========>
===============================> > "Name"            string
Kernel argument name.
> > "TypeName"        string                   Kernel argument
type name.
> > "Size"            integer        Required  Kernel argument
size in bytes.
> > "Align"           integer        Required  Kernel argument
alignment in
> >                                             bytes. Must be a power of
> two.
> > "ValueKind"       string         Required  Kernel argument
kind that
> >
> >
>
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
> >
> > SW versions:
> >
> > OS: NAME="Ubuntu" VERSION="16.04.6 LTS (Xenial
Xerus)"
> >
> > sphinx: '1.3.6'
> >
> > recommonmark: 0.6.0
> >
> > Thanks for your help.
> >
> >
> > lsg
> >
> >
> >
> > _______________________________________________
> > LLVM Developers mailing list
> > llvm-dev at lists.llvm.org
> > https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
>
>
>
> --
> Lerne, wie die Welt wirklich ist,
> aber vergiss niemals, wie sie sein sollte.
> _______________________________________________
> LLVM Developers mailing list
> llvm-dev at lists.llvm.org
> https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20191219/1b07776f/attachment.html>