From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755566AbcBPRLh (ORCPT ); Tue, 16 Feb 2016 12:11:37 -0500 Received: from mga02.intel.com ([134.134.136.20]:53811 "EHLO mga02.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755189AbcBPRLd (ORCPT ); Tue, 16 Feb 2016 12:11:33 -0500 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.22,456,1449561600"; d="scan'208";a="916141594" From: Jani Nikula To: Jonathan Corbet Cc: LKML , linux-doc@vger.kernel.org, Keith Packard , Daniel Vetter Subject: Re: Kernel docs: muddying the waters a bit In-Reply-To: <20160216090803.5b4a44a2@lwn.net> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <20160213145317.247c63c7@lwn.net> <87oabhysc2.fsf@intel.com> <20160216090803.5b4a44a2@lwn.net> User-Agent: Notmuch/0.21+33~g570c0ae (http://notmuchmail.org) Emacs/24.4.1 (x86_64-pc-linux-gnu) Date: Tue, 16 Feb 2016 19:11:28 +0200 Message-ID: <87io1ofum7.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 Tue, 16 Feb 2016, Jonathan Corbet wrote: > 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. So the question is, are HTML, latex (for pdf and presumably ps), epub, texinfo, and man pages enough? My subjective opinion is they are enough, and whoever wants more can make it work for them using pandoc. It's not like we had this great publishing framework before that we'd be breaking. Quite the opposite, and it would be awesome to have a robust set of outputs actually working for the majority of people. > 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. Oh, totally agreed, I was just musing on potential follow-up work. BR, Jani. -- Jani Nikula, Intel Open Source Technology Center