Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 40933 - New Developer Document on proposed kernel output changes for 2.6
Summary: New Developer Document on proposed kernel output changes for 2.6
Status: VERIFIED LATER
Alias: None
Product: [OLD] Docs-developer
Classification: Unclassified
Component: Submit New Documentation (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Benny Chuang (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-02-08 20:52 UTC by Peter Johanson (RETIRED)
Modified: 2006-01-26 10:22 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
Developer Document detailing the proposed koutput changes (2.6-koutput.xml,14.40 KB, text/plain)
2004-02-08 20:54 UTC, Peter Johanson (RETIRED)
Details
Reviewed 2.6-koutput.xml document (2.6-koutput.xml,14.92 KB, text/xml)
2004-02-09 10:58 UTC, Sven Vermeulen (RETIRED)
Details
Updated doc adding info about latest developments (2.6-koutput.xml,17.87 KB, text/plain)
2004-02-09 20:23 UTC, Peter Johanson (RETIRED)
Details
Updated 2.6-koutput.xml (2.6-koutput.xml,17.87 KB, text/xml)
2004-02-10 06:56 UTC, Sven Vermeulen (RETIRED)
Details
Added descriptions of a few extra functions, and clarified a few spots (2.6-koutput.xml,18.84 KB, text/plain)
2004-02-11 21:51 UTC, Peter Johanson (RETIRED)
Details
Updated 2.6-koutput.xml (2.6-koutput.xml,18.86 KB, text/xml)
2004-02-12 00:27 UTC, Sven Vermeulen (RETIRED)
Details
Little more info on some variables (2.6-koutput.xml,20.51 KB, text/plain)
2004-02-12 13:46 UTC, Peter Johanson (RETIRED)
Details
Revision to reflect new eclass name and function names (kernel-mod -> kmod) (2.6-koutput.xml,19.31 KB, text/plain)
2004-03-15 23:00 UTC, Peter Johanson (RETIRED)
Details
Fix coding sytle (2.6-koutput.xml.patch,1.43 KB, patch)
2004-03-25 16:44 UTC, Benny Chuang (RETIRED)
Details | Diff
Diff to fix references to kernel-config (2.6-koutput.xml.config-kernel.diff,2.09 KB, patch)
2004-03-26 10:47 UTC, Peter Johanson (RETIRED)
Details | Diff
Spelling + link addition changes (2.6-koutput.xml.spelling.diff,2.76 KB, patch)
2004-03-27 23:54 UTC, Peter Johanson (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Peter Johanson (RETIRED) gentoo-dev 2004-02-08 20:52:06 UTC
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:
Comment 1 Peter Johanson (RETIRED) gentoo-dev 2004-02-08 20:54:07 UTC
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
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2004-02-09 10:58:04 UTC
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.
Comment 3 Peter Johanson (RETIRED) gentoo-dev 2004-02-09 20:23:51 UTC
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.)
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2004-02-10 06:56:29 UTC
Created attachment 25339 [details]
Updated 2.6-koutput.xml

Fixed a few paragraphs (not many, I can count them on a single hand).
Comment 5 Peter Johanson (RETIRED) gentoo-dev 2004-02-11 21:51:34 UTC
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
Comment 6 Sven Vermeulen (RETIRED) gentoo-dev 2004-02-12 00:27:54 UTC
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
Comment 7 Peter Johanson (RETIRED) gentoo-dev 2004-02-12 13:46:37 UTC
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.
Comment 8 Peter Johanson (RETIRED) gentoo-dev 2004-03-15 23:00:38 UTC
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
Comment 9 Benny Chuang (RETIRED) gentoo-dev 2004-03-25 16:44:57 UTC
Created attachment 28025 [details, diff]
Fix coding sytle

committed to CVS, remain unlinked
Comment 10 Peter Johanson (RETIRED) gentoo-dev 2004-03-26 10:47:32 UTC
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)
Comment 11 Benny Chuang (RETIRED) gentoo-dev 2004-03-26 15:10:07 UTC
applied diff to cvs
Comment 12 Peter Johanson (RETIRED) gentoo-dev 2004-03-27 23:54:53 UTC
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 13 Benny Chuang (RETIRED) gentoo-dev 2004-03-28 00:13:20 UTC
Comment on attachment 28194 [details, diff]
Spelling + link addition changes

updated cvs
Comment 14 Benny Chuang (RETIRED) gentoo-dev 2004-03-28 00:13:53 UTC
updated
Comment 15 Benny Chuang (RETIRED) gentoo-dev 2004-06-22 07:40:02 UTC
*cough* shall I close this and the user doc? *cough*
Comment 16 Benny Chuang (RETIRED) gentoo-dev 2004-06-24 05:58:41 UTC
Marking as LATER
<latexer> BennyC: the kernel people decided to complicate things. you can mark them LATER or something if you want.
Comment 17 Marcelo Goes (RETIRED) gentoo-dev 2006-01-26 10:22:08 UTC
Closing this bug as per Josh's request in gentoo-doc's ML.