From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S934257AbcIPRUt (ORCPT ); Fri, 16 Sep 2016 13:20:49 -0400 Received: from smtprelay0002.hostedemail.com ([216.40.44.2]:35894 "EHLO smtprelay.hostedemail.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1755563AbcIPRUl (ORCPT ); Fri, 16 Sep 2016 13:20:41 -0400 X-Session-Marker: 6A6F6540706572636865732E636F6D X-Spam-Summary: 2,0,0,,d41d8cd98f00b204,joe@perches.com,:::::::::::::,RULES_HIT:41:355:379:421:541:599:800:960:968:973:988:989:1260:1277:1311:1313:1314:1345:1359:1373:1437:1515:1516:1518:1534:1541:1593:1594:1711:1730:1747:1777:1792:2198:2199:2393:2553:2559:2562:2828:2895:3138:3139:3140:3141:3142:3353:3622:3743:3865:3866:3867:3868:3870:3871:3873:3874:4250:4321:5007:6119:7875:10004:10400:10450:10455:10848:10967:11232:11658:11914:12050:12114:12740:13069:13200:13229:13255:13311:13357:13439:13894:14096:14097:14181:14659:14721:19904:19999:21080:30054:30060:30070:30090: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:1,LUA_SUMMARY:none X-HE-Tag: top74_3fc4dd002414b X-Filterd-Recvd-Size: 2428 Message-ID: <1474046437.32273.80.camel@perches.com> Subject: Re: [PATCH v3 05/21] Documentation/applying-patches.txt: convert it to ReST markup From: Joe Perches To: Jonathan Corbet , Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Markus Heiser , Jani Nikula , LKML Date: Fri, 16 Sep 2016 10:20:37 -0700 In-Reply-To: <20160916111026.281b02c7@lwn.net> References: <8aa5f588945e0fbf29d55639cfe0dbcc1694cfc7.1473849886.git.mchehab@s-opensource.com> <20160916111026.281b02c7@lwn.net> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.21.91-1ubuntu1 Mime-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 2016-09-16 at 11:10 -0600, Jonathan Corbet wrote: > On Wed, 14 Sep 2016 08:06:34 -0300 Mauro Carvalho Chehab wrote: > - use the correct markup to identify each section; > - Add some blank lines for Sphinx to properly interpret >   the markups; > - Remove a blank space on some paragraphs; > - Fix the verbatim and bold markups; > - Cleanup the remaining errors to make Sphinx happy. > So I certainly don't have a problem with the changes made to this file, but > there is some discomfort at a higher level: > +Last update: > + 2006-01-05 > I have to wonder what the value of a document saying how to FTP the patch > and move up to 2.6.13 is in 2016. > Who knows, there might still be value in a discussion of using the patch > tool. But I think we should seriously consider making a "historical" > section for documents that are nearing or past their expiration dates. Or just entirely delete historical document sections. All the older kernel sources would still have them so I don't see much of a need to keep the archival valued documentation bits in the current kernel source tree. Suggesting using tools other than git seems wrong today. And thank you Mauro for the relatively thankless effort to cleanse and modernize the process documentation.