From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752601AbcGANcA (ORCPT ); Fri, 1 Jul 2016 09:32:00 -0400 Received: from mga09.intel.com ([134.134.136.24]:10699 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751981AbcGANbs (ORCPT ); Fri, 1 Jul 2016 09:31:48 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.26,557,1459839600"; d="scan'208";a="1013498012" From: Jani Nikula To: Mauro Carvalho Chehab Cc: Markus Heiser , 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: [docs-next PATCH] Documentation/sphinx: skip build if user requested specific DOCBOOKS In-Reply-To: <20160701101555.5a8efce9@recife.lan> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <1467374614-3747-1-git-send-email-jani.nikula@intel.com> <1467375884-10245-1-git-send-email-jani.nikula@intel.com> <20160701101555.5a8efce9@recife.lan> User-Agent: Notmuch/0.22+12~gbdd9442 (http://notmuchmail.org) Emacs/24.4.1 (x86_64-pc-linux-gnu) Date: Fri, 01 Jul 2016 16:31:14 +0300 Message-ID: <87a8i1pjrx.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, Mauro Carvalho Chehab wrote: > Em Fri, 1 Jul 2016 15:24:44 +0300 > Jani Nikula escreveu: > >> If the user requested specific DocBooks to be built using 'make >> DOCBOOKS=foo.xml htmldocs', assume no Sphinx build is desired. This >> check is transitional, and can be removed once we drop the DocBook >> build. > > I guess this is actually a wrong assumption. I mean, it is valid to > build multiple documents at the same time. Sometimes I do things > like: > make DOCBOOKS="media_api.xml device-drivers.xml" htmldocs > > When I want both docs to be compiled. > > What I would be expecting is that Sphinx would be looking into > the DOCBOOKS targets and see if (some) of them belongs to it. > > Alternatively, we could add a separate makefile var for the > Sphinx targets, but the logic would be more complex, as it > should: Please let's not conflate DOCBOOKS to mean something other than DocBooks. I think it'll be easier that way. So I guess we'll need a way to build just a subset of the Sphinx documentation. I would like that to be a somewhat generic thing, not requiring a separate conf file for each subset. Is the granularity of a directory enough? I've been meaning to look into passing different and to sphinx-build for this, but I don't have the time now. BR, Jani. -- Jani Nikula, Intel Open Source Technology Center