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

From: Rob Landley
Date: Wed Feb 20 2013 - 20:02:06 EST


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--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/