Re: [PATCH] Documentation cleanup, update 00-INDEX files in Documentation/

[Rob Landley <rob@landley.net>]

On 01/29/14 18:27, Henrik Austad wrote:
> Some of the 00-INDEX files are somewhat outdated and some folders does not
> contain 00-INDEX at all. Only outdated (with the notably exception of
> spi) indexes are touched here, the 169 folders without 00-INDEX has not
> been touched.
>
> This applies to Linus' tip (0e47c969).

Looks like an improvement.

Acked-by: Rob Landley <rob@landley.net>

(My own scripts to find this stuff are based on maintaining 
http://kernel.org/doc and the kernel developers are no longer capable of 
providing rsync access to that, despite repeated requests. Most recently 
https://bugzilla.kernel.org/show_bug.cgi?id=52721 )

However, I'm curious about this bit:

> --- a/Documentation/00-INDEX
> +++ b/Documentation/00-INDEX
> @@ -1,11 +1,11 @@
>
> -This is a brief list of all the files in ./linux/Documentation and what
> -they contain. If you add a documentation file, please list it here in
> -alphabetical order as well, or risk being hunted down like a rabid dog.
> -Please keep the descriptions small enough to fit on one line.
> -							 Thanks -- Paul G.
> +# This is a brief list of all the files in ./linux/Documentation and what
> +# they contain. If you add a documentation file, please list it here in
> +# alphabetical order as well, or risk being hunted down like a rabid dog.
> +# Please keep the descriptions small enough to fit on one line.
> +# 							 Thanks -- Paul G.
>
> -Following translations are available on the WWW:
> +# Following translations are available on the WWW:

Is there a reason for that?

Rob