* [dpdk-dev] make doc fails @ 2019-06-21 19:56 Stephen Hemminger 2019-06-23 22:46 ` Thomas Monjalon 0 siblings, 1 reply; 6+ messages in thread From: Stephen Hemminger @ 2019-06-21 19:56 UTC (permalink / raw) To: John McNamara, Marko Kovacevic, Thomas Monjalon; +Cc: dev Just tried make doc on current DPDK tree and it fails: /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:7: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:25: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:190: WARNING: undefined label: multi_process_app (if the link has no caption the label must precede a section header) Not sure what the bad commit is. Also, not sure why CI didn't catch it. ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] make doc fails 2019-06-21 19:56 [dpdk-dev] make doc fails Stephen Hemminger @ 2019-06-23 22:46 ` Thomas Monjalon 2019-06-24 14:53 ` Ferruh Yigit 0 siblings, 1 reply; 6+ messages in thread From: Thomas Monjalon @ 2019-06-23 22:46 UTC (permalink / raw) To: Stephen Hemminger; +Cc: John McNamara, Marko Kovacevic, dev 21/06/2019 21:56, Stephen Hemminger: > Just tried make doc on current DPDK tree and it fails: > > /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:7: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) > /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:25: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) > /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:190: WARNING: undefined label: multi_process_app (if the link has no caption the label must precede a section header) These are only warnings, not fatal failues. > Not sure what the bad commit is. Also, not sure why CI didn't catch it. It works well on my machine (with some warnings). ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] make doc fails 2019-06-23 22:46 ` Thomas Monjalon @ 2019-06-24 14:53 ` Ferruh Yigit 2019-06-24 15:04 ` Burakov, Anatoly 0 siblings, 1 reply; 6+ messages in thread From: Ferruh Yigit @ 2019-06-24 14:53 UTC (permalink / raw) To: Thomas Monjalon, Stephen Hemminger; +Cc: John McNamara, Marko Kovacevic, dev On 6/23/2019 11:46 PM, Thomas Monjalon wrote: > 21/06/2019 21:56, Stephen Hemminger: >> Just tried make doc on current DPDK tree and it fails: >> >> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:7: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) >> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:25: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) >> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:190: WARNING: undefined label: multi_process_app (if the link has no caption the label must precede a section header) > > > These are only warnings, not fatal failues. > >> Not sure what the bad commit is. Also, not sure why CI didn't catch it. > > It works well on my machine (with some warnings). The warnings are from .pdf conversion and they are there for a long time now, although there are warnings pdf files still generated. html files are generated by 'make doc-guides-html' and completes without warning, which verifies the .rst file syntax. ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] make doc fails 2019-06-24 14:53 ` Ferruh Yigit @ 2019-06-24 15:04 ` Burakov, Anatoly 2019-06-24 15:27 ` Stephen Hemminger 0 siblings, 1 reply; 6+ messages in thread From: Burakov, Anatoly @ 2019-06-24 15:04 UTC (permalink / raw) To: Ferruh Yigit, Thomas Monjalon, Stephen Hemminger Cc: John McNamara, Marko Kovacevic, dev On 24-Jun-19 3:53 PM, Ferruh Yigit wrote: > On 6/23/2019 11:46 PM, Thomas Monjalon wrote: >> 21/06/2019 21:56, Stephen Hemminger: >>> Just tried make doc on current DPDK tree and it fails: >>> >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:7: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:25: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:190: WARNING: undefined label: multi_process_app (if the link has no caption the label must precede a section header) >> >> >> These are only warnings, not fatal failues. >> >>> Not sure what the bad commit is. Also, not sure why CI didn't catch it. >> >> It works well on my machine (with some warnings). > > > The warnings are from .pdf conversion and they are there for a long time now, > although there are warnings pdf files still generated. > > html files are generated by 'make doc-guides-html' and completes without > warning, which verifies the .rst file syntax. > PDF's can't link to other PDF's (e.g. FAQ can't link to GSG), that's why these warnings happen. That's normal. -- Thanks, Anatoly ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] make doc fails 2019-06-24 15:04 ` Burakov, Anatoly @ 2019-06-24 15:27 ` Stephen Hemminger 2019-06-24 16:09 ` Morten Brørup 0 siblings, 1 reply; 6+ messages in thread From: Stephen Hemminger @ 2019-06-24 15:27 UTC (permalink / raw) To: Burakov, Anatoly Cc: Ferruh Yigit, Thomas Monjalon, John McNamara, Marko Kovacevic, dev On Mon, 24 Jun 2019 16:04:15 +0100 "Burakov, Anatoly" <anatoly.burakov@intel.com> wrote: > On 24-Jun-19 3:53 PM, Ferruh Yigit wrote: > > On 6/23/2019 11:46 PM, Thomas Monjalon wrote: > >> 21/06/2019 21:56, Stephen Hemminger: > >>> Just tried make doc on current DPDK tree and it fails: > >>> > >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:7: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) > >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:25: WARNING: undefined label: linux_gsg (if the link has no caption the label must precede a section header) > >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:190: WARNING: undefined label: multi_process_app (if the link has no caption the label must precede a section header) > >> > >> > >> These are only warnings, not fatal failues. > >> > >>> Not sure what the bad commit is. Also, not sure why CI didn't catch it. > >> > >> It works well on my machine (with some warnings). > > > > > > The warnings are from .pdf conversion and they are there for a long time now, > > although there are warnings pdf files still generated. > > > > html files are generated by 'make doc-guides-html' and completes without > > warning, which verifies the .rst file syntax. > > > > PDF's can't link to other PDF's (e.g. FAQ can't link to GSG), that's why > these warnings happen. That's normal. > Ok thanks for the explanation ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] make doc fails 2019-06-24 15:27 ` Stephen Hemminger @ 2019-06-24 16:09 ` Morten Brørup 0 siblings, 0 replies; 6+ messages in thread From: Morten Brørup @ 2019-06-24 16:09 UTC (permalink / raw) To: Stephen Hemminger, Burakov, Anatoly Cc: Ferruh Yigit, Thomas Monjalon, John McNamara, Marko Kovacevic, dev > -----Original Message----- > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Stephen Hemminger > Sent: Monday, June 24, 2019 5:28 PM > > On Mon, 24 Jun 2019 16:04:15 +0100 > "Burakov, Anatoly" <anatoly.burakov@intel.com> wrote: > > > On 24-Jun-19 3:53 PM, Ferruh Yigit wrote: > > > On 6/23/2019 11:46 PM, Thomas Monjalon wrote: > > >> 21/06/2019 21:56, Stephen Hemminger: > > >>> Just tried make doc on current DPDK tree and it fails: > > >>> > > >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:7: WARNING: > undefined label: linux_gsg (if the link has no caption the label must > precede a section header) > > >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:25: WARNING: > undefined label: linux_gsg (if the link has no caption the label must > precede a section header) > > >>> /home/shemminger/git/dpdk/doc/guides/faq/faq.rst:190: WARNING: > undefined label: multi_process_app (if the link has no caption the label > must precede a section header) > > >> > > >> > > >> These are only warnings, not fatal failues. > > >> > > >>> Not sure what the bad commit is. Also, not sure why CI didn't catch > it. > > >> > > >> It works well on my machine (with some warnings). > > > > > > > > > The warnings are from .pdf conversion and they are there for a long > time now, > > > although there are warnings pdf files still generated. > > > > > > html files are generated by 'make doc-guides-html' and completes > without > > > warning, which verifies the .rst file syntax. > > > > > > > PDF's can't link to other PDF's (e.g. FAQ can't link to GSG), that's why > > these warnings happen. That's normal. > > > > Ok thanks for the explanation Shouldn't the Makefile print a message to expect this warning just before the warning is emitted, so future confusion about this is avoided? Med venlig hilsen / kind regards - Morten Brørup ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2019-06-24 16:10 UTC | newest] Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2019-06-21 19:56 [dpdk-dev] make doc fails Stephen Hemminger 2019-06-23 22:46 ` Thomas Monjalon 2019-06-24 14:53 ` Ferruh Yigit 2019-06-24 15:04 ` Burakov, Anatoly 2019-06-24 15:27 ` Stephen Hemminger 2019-06-24 16:09 ` Morten Brørup
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).