From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933105AbcBPQIJ (ORCPT ); Tue, 16 Feb 2016 11:08:09 -0500 Received: from tex.lwn.net ([70.33.254.29]:43997 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932261AbcBPQIG (ORCPT ); Tue, 16 Feb 2016 11:08:06 -0500 Date: Tue, 16 Feb 2016 09:08:03 -0700 From: Jonathan Corbet To: Jani Nikula Cc: LKML , linux-doc@vger.kernel.org, Keith Packard , Daniel Vetter Subject: Re: Kernel docs: muddying the waters a bit Message-ID: <20160216090803.5b4a44a2@lwn.net> In-Reply-To: <87oabhysc2.fsf@intel.com> References: <20160213145317.247c63c7@lwn.net> <87oabhysc2.fsf@intel.com> Organization: LWN.net X-Mailer: Claws Mail 3.12.0 (GTK+ 2.24.28; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, 16 Feb 2016 10:25:49 +0200 Jani Nikula wrote: > However I didn't think Sphinx could produce docbook, and a quick search > doesn't convince me otherwise. Do you have some links to back this up? Somehow I was really sure of it, but I'm not finding it now. There is an extension out there, but it warns about being a "work in progress," so I'm not sure we can count it. Whether this is a show-stopper is indeed a good question. I doubt many people wanted the DocBook for its own sake, it's a matter of where you can go from there. But yes, it would be good to be sure on this point. > Sphinx might offer a way to drop docproc through the extension > mechanism, without resorting to the "separate-file approach". It might > be a more sensible approach as a whole. There's a certain elegance to it that I like, but it is an idea that needs to actually be demonstrated. It could also come later on, though, with the docproc or include mechanisms used for now. Thanks, jon