From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-yw1-f51.google.com (mail-yw1-f51.google.com [209.85.161.51]) by dpdk.org (Postfix) with ESMTP id B50502BEB for ; Mon, 17 Sep 2018 13:35:20 +0200 (CEST) Received: by mail-yw1-f51.google.com with SMTP id x83-v6so5274703ywd.4 for ; Mon, 17 Sep 2018 04:35:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind-com.20150623.gappssmtp.com; s=20150623; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=v5H7ZPCuWwrH7s1T0fyu+U//0ZKCzJ0Jl1t1l+yLMo4=; b=FFE85dfoluhlg7lVys5mtVe8v5hL+hWa8gB5aD72tisPDnbFCAQRAQyNvkfCOUQsyN qbf+uNlM4y1SxtrT4y8vdzSoHHCnIX5F56lyPwxK1c5ibOriW+zg+i08KPqAUD/BTp4b vHPB0WjdUsdlJeSRa0lu47lJJwNQGfrlEBulDP5ADZiMGHHOm8M0LFZ4fYDQdu7luGv4 d1O2mRm+WPwgHOeB0e8ya5lVfqtyYqSIg9/DpXEZ/u6lKVA9YRhp0xM3xCMwpqJf2XwS gZRYiEzBihDjtXvdqieD8diwGuxuit1mX1NsAL43dA3ywcAH/H3ejhh/U2BDr04ZCPu7 jChg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=v5H7ZPCuWwrH7s1T0fyu+U//0ZKCzJ0Jl1t1l+yLMo4=; b=BtjilhYo+rLs2crrUqZ4f1pOzfO4KYUZr1jiS2mWAQO/Ep4GwKzMYaQh/sR2L7FD/R 9ZiYpF+DgG5k6YxOTVhWwUFZRqD99jTFBmUYJyXfdxpE2EtrI1L0zExK5PDQmIGvxoak 5RrrL8iUnaQHeN+Z4nAGt/mT89wTUeelM8oxQW44EtlHZGBt1FqZPtCdkWwoEjJZqfqy C5WLl3gqXhrnVmxleapDjI3m5RJTAd1gQXNyjo7DrECYBWana1VMZiSSxTsGqtQNytuS 5pVKnuNKsFfE9ydlHHskLyGE0Kue4PS9vlSai0SbCUa5tQIlUHC4O0+l0u+QswHnCZDX RYmg== X-Gm-Message-State: APzg51Dy2zTLQRDYxibIuEfXyUfyMQ9rmY8UWb4T4pyyDo2pfW3ZbIuL BovWZ0nM5NDwBgWYeE0hCm1fAv7gyvbDIwwiOptK/A== X-Google-Smtp-Source: ANB0VdatxsdMEGLXsWJL5WTlv8J5fKSPCe81UZMQOM0NU3TD+inpPWk8knUwMgVzPdWqEBxSj4aWuXuNkSUiJJVQ/lQ= X-Received: by 2002:a81:98d:: with SMTP id 135-v6mr10004056ywj.278.1537184119815; Mon, 17 Sep 2018 04:35:19 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:a25:6fc2:0:0:0:0:0 with HTTP; Mon, 17 Sep 2018 04:34:59 -0700 (PDT) In-Reply-To: <13484845.OeNmVBkQ8T@xps> References: <13484845.OeNmVBkQ8T@xps> From: David Marchand Date: Mon, 17 Sep 2018 13:34:59 +0200 Message-ID: To: Thomas Monjalon Cc: "Mcnamara, John" , marko.kovacevic@intel.com, dev@dpdk.org, Christian Ehrhardt Content-Type: text/plain; charset="UTF-8" Subject: Re: [dpdk-dev] Warnings when building the doc on Ubuntu 18.04 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 17 Sep 2018 11:35:21 -0000 On Mon, Sep 17, 2018 at 12:15 PM, Thomas Monjalon 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@ubuntu1604:~# apt-cache rdepends latexmk latexmk Reverse Depends: latexila texlive-full texlive-full texlive-extra-utils # and on my ubuntu 18.04 marchand@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@ubuntu1604:~# apt-cache depends latexila |grep latexmk Recommends: latexmk root@ubuntu1604:~# apt-cache depends texlive-full |grep latexmk Depends: latexmk root@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