Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932566AbcLGPrn (ORCPT ); Wed, 7 Dec 2016 10:47:43 -0500 Received: from mail-wj0-f196.google.com ([209.85.210.196]:36450 "EHLO mail-wj0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752330AbcLGPrk (ORCPT ); Wed, 7 Dec 2016 10:47:40 -0500 Date: Wed, 7 Dec 2016 16:47:46 +0100 From: Daniel Vetter To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Jonathan Corbet , Markus Heiser , "David S. Miller" , Andrew Morton , Greg Kroah-Hartman , Mauro Carvalho Chehab , Geert Uytterhoeven Subject: Re: [PATCH 0/2] Add maintainers to the admin guide Message-ID: <20161207154746.utvwmi6zm7rht5fz@phenom.ffwll.local> Mail-Followup-To: Mauro Carvalho Chehab , Linux Doc Mailing List , Mauro Carvalho Chehab , LKML , Jonathan Corbet , Markus Heiser , "David S. Miller" , Andrew Morton , Greg Kroah-Hartman , Mauro Carvalho Chehab , Geert Uytterhoeven References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: Linux phenom 4.8.0-1-amd64 User-Agent: NeoMutt/20161104 (1.7.1) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1750 Lines: 46 On Fri, Dec 02, 2016 at 10:15:13AM -0200, Mauro Carvalho Chehab wrote: > That's my third attempt to add the MAINTAINERS contents to the admin-guide. > > On the past approaches, was planning to keep the documentation > about what's at the MAINTAINERS file inside it, but that would > require running an external script or use some Sphinx extension. > > This time, I took a much simpler approach: convert the initial > part of the MAINTAINERS file to ReST and move to a file at the > admin-guide. So, MAINTAINERS file will now contain only the > maintainer's database, and a single line pointing to its documentation. > > That should hopefully be a good compromise, as we can add its > contents to a Sphinx file without causing too much hasle. Yeah, this seems like a rather neat approach and hopefully keeps everyone happy. Will probably conflict since there's some in-flight patches to document the new B: tag a bit better. Anyway: Reviewed-by: Daniel Vetter > > > Mauro Carvalho Chehab (2): > MAINTAINERS: convert first part to ReST markup > MAINTAINERS: add it to the admin-guide > > Documentation/admin-guide/index.rst | 1 + > Documentation/admin-guide/maintainers.rst | 184 ++++++++++++++++++++++++++++++ > MAINTAINERS | 125 +------------------- > 3 files changed, 187 insertions(+), 123 deletions(-) > create mode 100644 Documentation/admin-guide/maintainers.rst > > -- > 2.9.3 > > > -- > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > the body of a message to majordomo@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch