From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S966064AbcIWQ0l (ORCPT ); Fri, 23 Sep 2016 12:26:41 -0400 Received: from smtprelay0222.hostedemail.com ([216.40.44.222]:39706 "EHLO smtprelay.hostedemail.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S966528AbcIWQ0j (ORCPT ); Fri, 23 Sep 2016 12:26:39 -0400 X-Session-Marker: 6A6F6540706572636865732E636F6D X-Spam-Summary: 2,0,0,,d41d8cd98f00b204,joe@perches.com,:::::::::::,RULES_HIT:41:355:379:541:599:982:988:989:1260:1277:1311:1313:1314:1345:1359:1373:1437:1515:1516:1518:1534:1540:1593:1594:1711:1730:1747:1777:1792:2393:2559:2562:2828:2919:3138:3139:3140:3141:3142:3352:3622:3743:3865:3866:3867:3868:3870:3871:3872:4321:5007:6119:6120:10004:10400:10848:11232:11658:11914:12043:12555:12740:12760:13069:13311:13357:13439:14659:21080:21433:21451:30012:30034:30051:30054:30060:30091,0,RBL:none,CacheIP:none,Bayesian:0.5,0.5,0.5,Netcheck:none,DomainCache:0,MSF:not bulk,SPF:fn,MSBL:0,DNSBL:none,Custom_rules:0:0:0,LFtime:4,LUA_SUMMARY:none X-HE-Tag: fuel24_90f925bf7b422 X-Filterd-Recvd-Size: 1777 Message-ID: <1474647994.1849.1.camel@perches.com> Subject: Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS From: Joe Perches To: Mauro Carvalho Chehab , Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , Mauro Carvalho Chehab , Linux Kernel Mailing List Date: Fri, 23 Sep 2016 09:26:34 -0700 In-Reply-To: <20160923120733.546a4b7a@vento.lan> References: <20160923120733.546a4b7a@vento.lan> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.21.91-1ubuntu1 Mime-Version: 1.0 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 2016-09-23 at 12:07 -0300, Mauro Carvalho Chehab wrote: > So, let's use an unusual approach: manually convert the > text at the MAINTAINERS file head, adding it at a new > Documentation/user/MAINTAINERS.rst, and include, as a code > block, the rest of MAINTAINERS contents, with only the > contents of the maintainers entries. > > There's a side effect of this approach: now, if the > explanation text at the MAINTAINERS file is touched, it should be > modified also at the Documentation/user/MAINTAINERS.rst file. > Yet, as the number of changes there are small, this > should be manageable. couldn't this be a generated file from some awk script instead of being duplicated content with a plea to be kept in sync? > diff --git a/Documentation/user/MAINTAINERS.rst b/Documentation/user/MAINTAINERS.rst > new file mode 100644 [etc]