From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1030335AbcJRP7S (ORCPT ); Tue, 18 Oct 2016 11:59:18 -0400 Received: from out1-smtp.messagingengine.com ([66.111.4.25]:48979 "EHLO out1-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S964885AbcJRP7K (ORCPT ); Tue, 18 Oct 2016 11:59:10 -0400 X-Sasl-enc: kFlnO6h9IDd79FN4JOxaJiwda7uhen90Pq7ThaWYeWpW 1476806348 Date: Tue, 18 Oct 2016 17:59:17 +0200 From: Greg KH To: Markus Heiser Cc: "Hans J . Koch" , Stephen Hemminger , Jonathan Corbet , kvm@vger.kernel.org, devel@linuxdriverproject.org, "linux-kernel @ vger . kernel . org Mailing List" , "linux-doc @ vger . kernel . org Mailing List" Subject: Re: [PATCH] doc-rst: DocBook to reST migration of the uio-howto.tmpl Message-ID: <20161018155917.GB13567@kroah.com> References: <1476805978-23336-1-git-send-email-markus.heiser@darmarit.de> <1476805978-23336-2-git-send-email-markus.heiser@darmarit.de> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1476805978-23336-2-git-send-email-markus.heiser@darmarit.de> User-Agent: Mutt/1.7.1 (2016-10-04) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Oct 18, 2016 at 05:52:58PM +0200, Markus Heiser wrote: > The migration is done with the dbxml2rst project with small additional > handmade. The uio-howto is chunked along its chapters into smal parts. "small"? :) And why small parts? Is that the new "desired" way? > > [1] https://return42.github.io/dbxml2rst/ > > Signed-off-by: Markus Heiser > --- > Documentation/DocBook/Makefile | 2 +- > Documentation/DocBook/uio-howto.tmpl | 1050 ---------------------- > Documentation/conf.py | 2 + > Documentation/index.rst | 1 + > Documentation/uio-howto/about_uio.rst | 150 ++++ > Documentation/uio-howto/aboutthisdoc.rst | 103 +++ > Documentation/uio-howto/conf.py | 10 + > Documentation/uio-howto/custom_kernel_module.rst | 245 +++++ > Documentation/uio-howto/index.rst | 45 + > Documentation/uio-howto/uio_pci_generic.rst | 168 ++++ > Documentation/uio-howto/userspace_driver.rst | 86 ++ As this isn't just a howto, can we have it in Documentation/uio/ instead? Or, if we are going to mirror the source tree, would Documentation/drivers/uio/ make more sense? I'll defer to the Documentation maintainer about this as I'm sure they have an idea of what they want to do. thanks, greg k-h