linux-kernel - Re: Documentation of kernel messages (Summary)

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20070710185415.GA3492@stusta.de>
Date:	Tue, 10 Jul 2007 20:54:15 +0200
From:	Adrian Bunk <bunk@...sta.de>
To:	Rob Landley <rob@...dley.net>
Cc:	"H. Peter Anvin" <hpa@...or.com>,
	"Kunai, Takashi" <kunai@...ux-foundation.jp>,
	holzheu@...ux.vnet.ibm.com,
	Andrew Morton <akpm@...ux-foundation.org>,
	linux-kernel@...r.kernel.org,
	lf_kernel_messages@...ux-foundation.org, mtk-manpages@....net,
	jack@...e.cz, randy.dunlap@...cle.com, gregkh@...e.de,
	pavel@....cz, tim.bird@...sony.com, gh@...ibm.com,
	arjan@...radead.org, sam@...nborg.org, jengelh@...putergmbh.de,
	joe@...ches.com, auke-jan.h.kok@...el.com, hansendc@...ibm.com,
	davem@...emloft.net, Valdis.Kletnieks@...edu, kenistoj@...ibm.com,
	schwidefsky@...ibm.com, heiko.carstens@...ibm.com,
	linux-doc@...r.kernel.org
Subject: Re: Documentation of kernel messages (Summary)

On Tue, Jul 10, 2007 at 12:25:31PM -0400, Rob Landley wrote:
>...
> Let's look at _english_ documentation.
> 
> If you go to http://kernel.org/doc/ols you should find, nicely split up, all 
> the OLS papers from 2002-2007.  By my count, there are 337 of them, totaling 
> 61.8 megabytes when they're split up like that.  Being PDFs, they don't 
> compress all that well.
> 
> Which subset of these should be copied into the Documentation directory?

You don't have to copy everything.

And you anyway have to handle cases like e.g. most books where you are 
not permitted to copy them, but might want to point people to them.

> How 
> do you update them?  This is the documentation from just ONE SOURCE.

You aren't legally permitted to update any OLS paper unless you've 
gotten explicit permission by the author. And when he gives legal 
permission, he can as well give you the LaTeX source. I'd expect legal 
and technical update possibilities to usually be related this way.

And you shouldn't include non-free documentation into the kernel sources.

> And PDF isn't close to the worst of it: Linuxconf.au has lots of video, as 
> does google video.  (I don't even have _english_ transcripts for those 
> videos, which would be nice.)  Do you want to merge all of this into the 
> kernel tarball as well?

Not at all.

> How does this help keep anything up to date?

You can only update things you are legally and technically able to 
update. For the rest, you can only ship pointers like kernel-docs.txt.

> Rob

cu
Adrian

-- 

       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed

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