Re: [PATCH] Documentation: cover CONFIG_BINFMT_SCRIPT in init.txt

From: Rob Landley
Date: Thu Jun 06 2013 - 21:33:30 EST


On 06/03/2013 03:26:56 PM, Andreas Mohr wrote:
Hi,

On Mon, Jun 03, 2013 at 06:16:12AM -0500, Rob Landley wrote:
> On 05/30/2013 03:33:10 PM, Andreas Mohr wrote:
> >It's somewhat sad to see that that file remained at only one
> >initial commit
> >since 2010, thus thumbs up for your help!
> >
> >Docs in general seem to be a wee bit too unmaintained.
>
> Are you volunteering?

Yeah (sort of ;) - in fact I keep piling up some doc updates locally
and am just waiting for them to reach critical mass
(but first I need to get some certain driver updates submitted anyway).

Andreas Mohr

No one person is an expert in every file in Documentation. My big todo items are centered around librarian work: reorganizing the layout of the directory so it's not a giant heap with everybody in the world dumping stuff into the root directory, or weird little crevices like pti/ and pps/ that have their own directory with one file in it.

Unfortunately, Documentation is the greatest source of bikeshedding in the kernel. Even as the directory's nominal maintainer, I can't say "translations don't belong in there, they belong on the web" because Greg KH thinks they do so he'll check them in anyway. And then nobody maintains them because anybody who can read the english versions (and thus update the translations) doesn't need the translations.

There's functional stuff in there like the devicetree bindings. There's a Makefile that compiles stuff under Documentation, and not just the htmldocs but actual code. I still don't really know why...

Unfortunately, I only really get time to deal with this sort of thing in the downtime between contracts, and last time I had a gap the massive barn-door-locking after the kernel.org breakin still had my account disabled because I hadn't been to an in-person conference to get a new pgp key signed in years. (And now that I've been to a conference and gotten one signed, I need to sit down and write a new rsync replacement on top of kup because non-security people wrote a bespoke security wrapper for kernel.org to replace shell access, which means my old rsync script that updated http://kernel.org/doc needs to be replaced with a rube goldberg monstrosity to do the same thing in a much more complicated and less efficient way.)

It's on the todo list. (You may have noticed I'm a couple days behind on just email. Next scheduled gap's in August...)

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/