[dpdk-dev] Warnings when building the doc on Ubuntu 18.04

[David Marchand]

On Mon, Sep 17, 2018 at 12:15 PM, Thomas Monjalon <thomas at monjalon.net> wrote:
> 17/09/2018 11:59, David Marchand:
>> Hello,
>>
>> I tried to build the documentation but it looks like the instructions
>> about how to build it are not up to date. Currently running Ubuntu
>> 18.04, it might be the reason.
>
> In pkg/dpdk.spec, there is this requirement (for RedHat based distro):
>         doxygen, python-sphinx, inkscape, texlive-collection-latexextra
> I am not sure it is up to date though.
>
> There is also a guide listing the dependencies:
>         doc/guides/contributing/documentation.rst
> Here, it is mentioned
>         TexLive (at least TexLive-core and the extra Latex support)
> and
>         # Ubuntu/Debian.
>         sudo apt-get -y install texlive-latex-extra

I followed this doc, yes.

> Is it enough? Or is there a miss?

I am more under the impression that there is a pb.

# on a fresh Ubuntu 16.04,

root at ubuntu1604:~# apt-cache rdepends latexmk
latexmk
Reverse Depends:
  latexila
  texlive-full
  texlive-full
  texlive-extra-utils

# and on my ubuntu 18.04
marchand at gribouille:~$ apt-cache rdepends latexmk
latexmk
Reverse Depends:
  latexila
  texlive-full
  texlive-extra-utils
  python-sphinx
  python3-sphinx
  jupyter-sphinx-theme-doc

texlive-latex-extra does not depend on latexmk.
So 16.04 vs 18.04 is not the issue.


Looking again at 16.04 :

root at ubuntu1604:~# apt-cache depends latexila |grep latexmk
  Recommends: latexmk
root at ubuntu1604:~# apt-cache depends texlive-full |grep latexmk
  Depends: latexmk
root at ubuntu1604:~# apt-cache depends texlive-extra-utils |grep latexmk
  Suggests: latexmk

So texlive-full is the only that has a hard dependency on it.


>> After this, I still see those warnings (and actually a lot of others).
>> The pdf generated docs have no link in them, but the html ones are fine.
>> Is is expected ?
>
> The warnings are about the cross-doc links.
> I think links are working inside a PDF but obviously not when referencing
> another PDF document.
> Do you see a different issue?

Two types of warnings, "unknown label" and "unknown document".

The "unknown label" warnings seem to be cross doc links, yes.
But some unknown document warnings are odd to me.
I will look at this a bit more.


-- 
David Marchand