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

Nicolai Hähnle via llvm-dev
Thu, 19 Dec 2019 09:06:01 -0000

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.