From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752159AbcGAM2s (ORCPT ); Fri, 1 Jul 2016 08:28:48 -0400 Received: from mga04.intel.com ([192.55.52.120]:16068 "EHLO mga04.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751280AbcGAM2r (ORCPT ); Fri, 1 Jul 2016 08:28:47 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.26,556,1459839600"; d="scan'208";a="1013465216" From: Jani Nikula To: Markus Heiser Cc: Mauro Carvalho Chehab , Jonathan Corbet , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, hverkuil@xs4all.nl, daniel.vetter@ffwll.ch, airlied@gmail.com, grant.likely@secretlab.ca, rdunlap@infradead.org, keithp@keithp.com Subject: Re: [PATCH] doc: flat-table directive In-Reply-To: <34141ADD-F1D2-4155-AC94-29C9C7199D6E@darmarit.de> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <1467288022-10496-1-git-send-email-markus.heiser@darmarIT.de> <20160630130511.34b732e6@lwn.net> <20160630164420.4e3908de@recife.lan> <20160701063857.674bde86@recife.lan> <87shvtpri6.fsf@intel.com> <87mvm1po6k.fsf@intel.com> <34141ADD-F1D2-4155-AC94-29C9C7199D6E@darmarit.de> User-Agent: Notmuch/0.22+12~gbdd9442 (http://notmuchmail.org) Emacs/24.4.1 (x86_64-pc-linux-gnu) Date: Fri, 01 Jul 2016 15:26:45 +0300 Message-ID: <87furtpmre.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 01 Jul 2016, Markus Heiser wrote: > Am 01.07.2016 um 13:56 schrieb Jani Nikula : > >> On Fri, 01 Jul 2016, Markus Heiser wrote: >>> Am 01.07.2016 um 12:44 schrieb Jani Nikula : >>> >>>> On Fri, 01 Jul 2016, Mauro Carvalho Chehab wrote: >>>>> Not being able to compile just one docbook is a regression and breaks >>>>> my process. This needs to be fixed. >>>> >>>> Do you have a regression with *DocBook XML* on docs-next now? If yes, >>>> clearly that must be fixed ASAP. >>> >>> Now I see the problem ... >>> >>> It seems that we didn't neglected that the DocBook Makefile >>> builds single books, e.g. >>> >>> make DOCBOOKS=device-drivers.xml htmldocs >>> >>> Since the Makefile.sphinx does not care the environment DOCBOOKS, >>> the XML is build and the reST also, where only the XML content >>> should be build. >>> >>> Jani, may could you apply a small fix on the Makefile.sphinx which >>> takes into account, not to run the sphinx-build if the DOCBOOK >>> environment is set .. is it a solution for a start? >> >> That is not the problem. Makefile.sphinx happily ignores DOCBOOKS. For >> example 'make DOCBOOKS=kernel-api.xml htmldocs' on docs-next works just >> fine for me. Sphinx build ignores DOCBOOKS, the DocBook build works just >> like it always did. > > Are you sure .. may I do something wrong:: > > $ make DOCBOOKS=kernel-api.xml htmldocs > SPHINX htmldocs > Running Sphinx v1.4.4 > loading pickled environment... done > building [mo]: targets for 0 po files that are out of date > building [html]: targets for 0 source files that are out of date > updating environment: 0 added, 0 changed, 0 removed > looking for now-outdated files... none found > no targets are out of date. > build succeeded. > DOCPROC Documentation/DocBook/kernel-api.xml > .//lib/crc32.c:148: warning: No description found for parameter 'tab)[256]' > .//lib/crc32.c:148: warning: Excess function parameter 'tab' description in 'crc32_le_generic' > .//lib/crc32.c:293: warning: No description found for parameter 'tab)[256]' > .//lib/crc32.c:293: warning: Excess function parameter 'tab' description in 'crc32_be_generic' > .//lib/crc32.c:1: warning: no structured comments found > .//mm/memory.c:2881: warning: No description found for parameter 'old' > XMLREF Documentation/DocBook/kernel-api.aux.xml > HTML Documentation/DocBook/kernel-api.html > .... > > In this example, the sphinx build is started as a side effect > even if it is not rebuild in this example, because nothing > in reST content has changed: "looking for now-outdated files... none found". > > As far as I can see, this is done **because** Makefile.sphinx > ignores DOCBOOK. I was referring to the original problem Mauro reported where the build failed. The above is a different issue, but an issue nonetheless. Patch sent. BR, Jani. -- Jani Nikula, Intel Open Source Technology Center