Opening this bug to attach new documentation for the proposed changes to 2.6 kernels as dicussed in great detail in bug #32737. I've got a document geared towards developers mostly finished which needs some attention, and another geared towards users which will hopefully be finished soon. The document in more digestible form is here: http://dev.gentoo.org/~latexer/2.6-koutput.html
I will attach it directly. The hope is to have all the documentation ready and in place for when the transition eventually occurs. More than that, I'd like this document available in combination with the information on bug #32737 so that more developers may digest, test, and comment on the proposed changes.
Steps to Reproduce:
Created attachment 25229 [details]
Developer Document detailing the proposed koutput changes
Work in progress to enable other developers to test and create new ebuilds for
the proposed 2.6 kernel changes
Created attachment 25276 [details]
Reviewed 2.6-koutput.xml document
This is a reviewed version with coding style applied, some grammer/spelling
fixes but no content change.
Created attachment 25314 [details]
Updated doc adding info about latest developments
Okay, updated doc including information on latest kernel-mod stuff that
includes KV_BUILD variable and using the "fake sources" method for backwards
(now that i've seen it, hopefully i've fallen in line with the right coding
style for our docs.)
Created attachment 25339 [details]
Fixed a few paragraphs (not many, I can count them on a single hand).
Created attachment 25457 [details]
Added descriptions of a few extra functions, and clarified a few spots
Minor changes to clarify and add more info on fine grained use to match latest
kernel-mod.eclass patch on bug #32737
Created attachment 25461 [details]
Two minor changes:
- Moved the (so KV_BUIDL and KV_OUTPUT are sort of "flipped") inside the
sentence it preceded
- Add indentation between <ti>..</ti> in case it spans multiple lines
Created attachment 25496 [details]
Little more info on some variables
Okay, i've added a table to help clarify what KV_BUILD and KV_OUTPUT end up
being set to in each of the 3 possible different situations.
Created attachment 27437 [details]
Revision to reflect new eclass name and function names (kernel-mod -> kmod)
Okay, this shouldn't have much in the way of changes from the last version,
just updated to reflect a decision to name the new elcass "kmod.eclass" instead
of the longer more annoying kernel-mod.eclass
Created attachment 28025 [details, diff]
Fix coding sytle
committed to CVS, remain unlinked
Created attachment 28081 [details, diff]
Diff to fix references to kernel-config
Hey, attached is a small patch to the version in CVS. Fixes date, changes
references to "kernel-config" to "config-kernel", and fixes a section which
still refered to the symlink method which is not what will actually be used.
Fixes for grammar, etc needed i'm sure. (latexer == math major)
applied diff to cvs
Created attachment 28194 [details, diff]
Spelling + link addition changes
Fixed a few spelling issues, and added an actual link to the user guide now
that the user guide actually exists. (:
Comment on attachment 28194 [details, diff]
Spelling + link addition changes
*cough* shall I close this and the user doc? *cough*
Marking as LATER
<latexer> BennyC: the kernel people decided to complicate things. you can mark them LATER or something if you want.
Closing this bug as per Josh's request in gentoo-doc's ML.