lkml.org 
[lkml]   [2016]   [Sep]   [16]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH v3 05/21] Documentation/applying-patches.txt: convert it to ReST markup
On Wed, 14 Sep 2016 08:06:34 -0300
Mauro Carvalho Chehab <mchehab@s-opensource.com> 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

\
 
 \ /
  Last update: 2016-09-17 09:59    [W:0.497 / U:0.124 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site