Re: [PATCH] Documentation/x86_64/00-INDEX

[Rob Landley <rob@landley.net>]

On Sunday 30 September 2007 3:35:03 pm Andi Kleen wrote:
> On Fri, Sep 28, 2007 at 07:44:02PM -0500, Rob Landley wrote:
> > From: Rob Landley <rob@landley.net>
> >
> > Add Documentation/x86_64/00-INDEX
>
> What's the point of this file?

It's for http://kernel.org/doc/Documentation/

I have a script that converts each 00-INDEX files into an index.html file, and 
then uses that instead of just a directory listing.  I'm trying to get 
complete coverage (a 00-INDEX file for each directory), although what I 
really need is no directories with _partial_ 00-INDEX files (because then 
using index.html instead of showing the directory listing would hide files).

If you want this directory to be special and _not_ have a 00-INDEX file, 
that's fine by me.  It screws up my 404 link checker, but I can hardwire in 
an exception for you...

> > +boot-options.txt
> > +	- AMD64-specific boot options.
>
> The architecture is not called AMD64 under Linux.

That line was cut and paste from the first line of boot-options.txt.  If you'd 
like to suggest another description, I'm all ears and can update the patch to 
touch boot-options.txt at the same time.

> > +mm.txt
> > +	- Memory layout of x86-64 (4 level page tables, 46 bits physical).
>
> I don't think such details as the 46 bit number should be in an index file.

*shrug*  Ok.

Rob
-- 
"One of my most productive days was throwing away 1000 lines of code."
  - Ken Thompson.
-
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/