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. Reproducible: Always 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 compatibility. (now that i've seen it, hopefully i've fallen in line with the right coding style for our docs.)
Created attachment 25339 [details] Updated 2.6-koutput.xml 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] Updated 2.6-koutput.xml 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 updated cvs
updated
*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.