[dpdk-dev] [PATCH] doc: fix PDF build of bbdev prog guide

[Thomas Monjalon]

18/07/2019 16:51, Chautru, Nicolas:
> From: Thomas Monjalon [mailto:thomas at monjalon.net] 
> >About the tables, there are simpler syntax in RsT:
> >http://docutils.sourceforge.net/docs/user/rst/quickref.html#tables
> 
> To be honest, I cannot see the problem with the current format which is following that structure already. 

You are using the grid table syntax.
I was referring to the simple table syntax as below:

	=====  =====  ======
	   Inputs     Output
	------------  ------
	  A      B    A or B
	=====  =====  ======
	False  False  False
	True   False  True
	False  True   True
	True   True   True
	=====  =====  ======

> What error message do you get on your machine?

That's the difficult thing with PDF build, we do not have
any clear error message. I had to bisect to find the root cause.

> This is not caught on DPDK CI, is it?

No and I cannot reproduce it on my laptop.
I see the failure only on dpdk.org which has a different OS version.

> >You can also consider the definition lists:
> >http://docutils.sourceforge.net/docs/user/rst/quickref.html#definition-lists
> 
> Clearer has a formal table from my point of view.

Yes maybe, it depends on what we want to document.