Date: Sat, 11 Aug 2007 14:33:34 -0700
From: Randy Dunlap <rdunlap@xenotime.net>
To: Rob Landley <rob@landley.net>
Cc: akpm@linux-foundation.org, linux-kernel@vger.kernel.org, paulus@samba.org
Subject: Re: [PATCH] Minor fix to Documentation/powerpc/00-INDEX
Message-Id: <20070811143334.60f90af4.rdunlap@xenotime.net>
In-Reply-To: <200708092342.35238.rob@landley.net>
References: <200708092342.35238.rob@landley.net>
Organization: YPO4
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 2376
Lines: 64

On Thu, 9 Aug 2007 23:42:35 -0500 Rob Landley wrote:

> Signed-off-by: Rob Landley <rob@landley.net>
> 
> I have a python script to convert 00-INDEX files into index.html files, and a
> second script to show 404 errors in the result as well as files/directories
> nothing links to.   (It's not very useful yet, but in case you're wondering
> http://kernel.org/doc/docdiridx.py and http://kernel.org/doc/doclinkcheck.py
> .)
> 
> Anyway, my simple index.html generator breaks on the Documentation/powerpc
> directory because one of the description lines is two lines long.  This
> patch joins those two lines together into one line.  This is the only
> instance (so far) of this problem.

If Paul wants to merge this, then OK, but I'm not aware of any rule
that the file descriptions inside INDEX files must be only one line
long... is that documented somewhere?  (if so, where?)

Maybe the script should allow for this?

> ---
> 
> In case you're wondering, here are the current the 404 errors in the
> various 00-INDEX files.  Fixing all this is on my todo list:
> 
> Documentation/ecryptfs.txt
> Documentation/time_interpolators.txt
> Documentation/arm/SA1100
> Documentation/arm/XScale
> Documentation/arm/empeg
> Documentation/arm/nwfpe
> Documentation/isdn/README.eicon
> Documentation/fb/clgenfb.txt
> Documentation/networking/ethertap.txt
> Documentation/filesystems/reiser4.txt
> Documentation/scsi/AM53C974.txt
> Documentation/scsi/ChangeLog
> 
> The "files and directories not linked to" list is 679 lines long.
> 
> diff -r /dev/null Documentation/powerpc/00-INDEX
> --- a/Documentation/powerpc/00-INDEX	Thu Aug 09 08:40:21 2007 -0700
> +++ b/Documentation/powerpc/00-INDEX	Thu Aug 09 20:49:03 2007 -0500
> @@ -6,8 +6,7 @@ 00-INDEX
>  00-INDEX
>  	- this file
>  cpu_features.txt
> -	- info on how we support a variety of CPUs with minimal compile-time
> -	options.
> +	- info on how we support a variety of CPUs with minimal compile-time options.
>  eeh-pci-error-recovery.txt
>  	- info on PCI Bus EEH Error Recovery
>  hvcs.txt


---
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/