From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754942AbcIPRKh (ORCPT ); Fri, 16 Sep 2016 13:10:37 -0400 Received: from tex.lwn.net ([70.33.254.29]:51307 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752877AbcIPRK2 (ORCPT ); Fri, 16 Sep 2016 13:10:28 -0400 Date: Fri, 16 Sep 2016 11:10:26 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Markus Heiser , Jani Nikula , LKML Subject: Re: [PATCH v3 05/21] Documentation/applying-patches.txt: convert it to ReST markup Message-ID: <20160916111026.281b02c7@lwn.net> In-Reply-To: <8aa5f588945e0fbf29d55639cfe0dbcc1694cfc7.1473849886.git.mchehab@s-opensource.com> References: <8aa5f588945e0fbf29d55639cfe0dbcc1694cfc7.1473849886.git.mchehab@s-opensource.com> Organization: LWN.net X-Mailer: Claws Mail 3.13.2 (GTK+ 2.24.30; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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. jon