From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933250AbcBPTNd (ORCPT ); Tue, 16 Feb 2016 14:13:33 -0500 Received: from home.keithp.com ([63.227.221.253]:59825 "EHLO elaine.keithp.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932948AbcBPTNc (ORCPT ); Tue, 16 Feb 2016 14:13:32 -0500 From: Keith Packard To: Jani Nikula , Jonathan Corbet , LKML , linux-doc@vger.kernel.org, Daniel Vetter Subject: Re: Kernel docs: muddying the waters a bit In-Reply-To: <87oabhysc2.fsf@intel.com> References: <20160213145317.247c63c7@lwn.net> <87oabhysc2.fsf@intel.com> User-Agent: Notmuch/0.21 (http://notmuchmail.org) Emacs/24.5.1 (x86_64-pc-linux-gnu) Date: Tue, 16 Feb 2016 11:13:29 -0800 Message-ID: <86egccii3q.fsf@hiro.keithp.com> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Jani Nikula writes: > 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? > Would the lack of docbook be a showstopper? (Of course, the pandoc > swiss-army knife can handle rst->docbook if needed.) A quick search yields: https://github.com/HolgerPeters/sphinxcontrib-docbook which appears to provide docbook output for sphinx, but I haven't tested this at all. 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. =2D-=20 =2Dkeith --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIVAwUBVsN02tsiGmkAAAARAQg1txAAiRHGtn2oYAS0Nc4VfrqUTIVNIVTkh+mZ 1dumED/oolEPdbjx2AdfUTNfCUXxJmDjtaF119ebGjg3DOwiAUkNwBAZlzqB+IJI d4OGeCZIZNUiVOVbQmWA0BZhW+IZFuoA9a4xSQqB2YTH96XJGKpeD0BRdzEtzDnA rNS6x7vf+E6nU7oYlInnlNuOI4HkPuW4u1cToc0qnOnKkT14ZQWiYS60izJJW9IU KztDtCPrVjiTr2LNW2nguQVBqlzRHp9sFS1OI1jDXZsH+FCdPtYLoX8ulS2Ox6Ml rmD/fSVhA/chUsjdMPhQoTXkwzupBmHBCm4B0mOoiHCk/JFI4l8jQikSE6YfkuTx ptNMb0uwPJ4hX69N5UT5EkoP0f/m4eq1eUn/48miE76e7lYQB5JDSWTwJgH7xI8Y D2o37K/TP3XvmN3WrkTnoNkmcHsytaa5nxEo2/wL2TCLizYqBsTPyb7jX82o+NA8 i3bcJJdLEi0ieNJhwucrn7EjnOErKVZ4aOAYMHkUZyaI2UenGAiVfWi77bpl6nVM CWt9zTya1FlftKpp8hbBdDZzPrgMY7cm0sqYl2fhc4smz5h+IzpHu0TtKT43uC1c PnrSnoXopCOD570bPI+SohgjQAVXZcOHuDXS3lajOarXYJ91XlSY3TPEdQZc9vih +gNBNKeIvDc= =ed81 -----END PGP SIGNATURE----- --=-=-=--