From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755390AbcBPT7G (ORCPT ); Tue, 16 Feb 2016 14:59:06 -0500 Received: from tex.lwn.net ([70.33.254.29]:44980 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753239AbcBPT7E (ORCPT ); Tue, 16 Feb 2016 14:59:04 -0500 Date: Tue, 16 Feb 2016 12:59:01 -0700 From: Jonathan Corbet To: Keith Packard Cc: Jani Nikula , LKML , linux-doc@vger.kernel.org, Daniel Vetter Subject: Re: Kernel docs: muddying the waters a bit Message-ID: <20160216125901.149c7849@lwn.net> In-Reply-To: <86egccii3q.fsf@hiro.keithp.com> References: <20160213145317.247c63c7@lwn.net> <87oabhysc2.fsf@intel.com> <86egccii3q.fsf@hiro.keithp.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 11:13:29 -0800 Keith Packard wrote: > https://github.com/HolgerPeters/sphinxcontrib-docbook > > which appears to provide docbook output for sphinx, but I haven't tested > this at all. Yup, that's the one I found, the one that says "Very much work in progress". It looks like that work stopped almost a year ago. > Of course, docbook is just a means to an end -- the question should > probably be what final output formats are actually required and whether > the tools generate those in a reasonable fashion. Indeed, I doubt many people want the DocBook itself. jon