Re: [PATCH] Documentation: update top level 00-INDEX file with new additions

Rob Landley
2013-02-21T01:01:49Z

On 02/18/2013 09:57:36 AM, Randy Dunlap wrote:
> On 02/18/13 01:39, Jiri Kosina wrote:
> > On Thu, 14 Feb 2013, Paul Gortmaker wrote:
> >
> >> It seems there are about 80 new, but undocumented addtions at
> >> the top level Documentation directory. This fixes up the top
> >> level 00-INDEX by adding new entries and deleting a couple orphans.
> >> Some subdirs could probably still use a check/cleanup too though.
>
> After this patch, I would prefer to see a requirement that each
> Documentation/
> file contain a "topic" line and then generate INDEX files from those
> automatically...
>
> comments?

I actually have a script that can audit the 00-INDEX files, as part of
my kernel.org/doc build stuff:

http://landley.net/hg/kdocs/file/tip/make

Manually auditing these isn't hard for me, it's just that since
kernel.org went all-in on locking the barn door after the horses
escaped, I haven't had access to my old kernel.org account (I need to
meed kernel developers in person to get keys signed, which doesn't
happen much).

And even if I did get a new ssh key, you don't get shell access anymore
you get "kup" which is a git wrapper you can't rsync through. So fixing
problem 1 opens up problem 2 and I still can't do anything useful.
(Navigating the new bureaucracy is on my todo list, but not really
something I sit down and go "oh boy, I should work on THIS" on any
given evening.)

So I haven't been able to update kernel.org/doc since the breakin, and
my tools for auditing the 00-INDEX files and htmldocs and menuconfig
and so on are all tied up with that.

Rob