Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: genkernel.xml
Date: Mon, 06 Dec 2010 12:00:48
Message-Id: 20101206120032.98FAD20054@flycatcher.gentoo.org
1 nightmorph 10/12/06 12:00:32
2
3 Modified: genkernel.xml
4 Log:
5 update genkernel guide. add license, update GRP link. also include sping's updates via ML.
6
7 Revision Changes Path
8 1.32 xml/htdocs/doc/en/genkernel.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.32&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?rev=1.32&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/genkernel.xml?r1=1.31&r2=1.32
13
14 Index: genkernel.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v
17 retrieving revision 1.31
18 retrieving revision 1.32
19 diff -u -r1.31 -r1.32
20 --- genkernel.xml 23 Jun 2008 05:07:13 -0000 1.31
21 +++ genkernel.xml 6 Dec 2010 12:00:32 -0000 1.32
22 @@ -1,8 +1,8 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.31 2008/06/23 05:07:13 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.32 2010/12/06 12:00:32 nightmorph Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 -<guide link="/doc/en/genkernel.xml" disclaimer="obsolete">
29 +<guide disclaimer="obsolete">
30 <title>Gentoo Linux Genkernel Guide</title>
31
32 <author title="Author">
33 @@ -19,16 +19,21 @@
34 <author title="Editor">
35 <mail link="nightmorph"/>
36 </author>
37 +<author title="Contributor">
38 + <mail link="sping"/>
39 +</author>
40
41 <abstract>
42 This guide intends to provide a reference of all the functions provided by
43 genkernel.
44 </abstract>
45
46 +<!-- The content of this document is licensed under the CC-BY-SA license -->
47 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
48 <license/>
49
50 -<version>1.6</version>
51 -<date>2008-06-22</date>
52 +<version>2</version>
53 +<date>2010-12-06</date>
54
55 <chapter>
56 <title>Introduction</title>
57 @@ -77,11 +82,10 @@
58
59 <p>
60 To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you
61 -are using the <uri
62 -link="/doc/en/handbook/2005.1/hb-install-about.xml#doc_chap2_sect1">Gentoo
63 +are using the <uri link="/doc/en/handbook/2008/hb-install-about.xml">Gentoo
64 Reference Platform</uri> (GRP), remember to install binary packages by passing
65 -the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of
66 -genkernel, the flags may be different. In any case, consult <c>genkernel
67 +the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version
68 +of genkernel, the flags may be different. In any case, consult <c>genkernel
69 --help</c> for help on how to use the version of genkernel installed on your
70 system.
71 </p>
72 @@ -259,12 +263,16 @@
73 compiled modules will be installed as well.
74 </li>
75 <li>
76 - <b>--<c>no-</c>initrdmodules</b>: Refrains from copying any modules to the
77 + <b>--<c>no-</c>ramdisk-modules</b>: Refrains from copying any modules to the
78 genkernel-created initrd image. This flag is an exception to the rule about
79 the <c>no-</c> prefix; omission of this prefix creates an invalid genkernel
80 flag.
81 </li>
82 <li>
83 + <b>--all-ramdisk-modules</b>: Copies all available modules to the
84 + genkernel-created initrd image.
85 + </li>
86 + <li>
87 <b>--genzimage</b>: Creates the initrd image, prior to the kernel image.
88 (This hack currently applies only to PPC Pegasos systems.)
89 </li>
90 @@ -348,15 +356,15 @@
91
92 <ul>
93 <li>
94 - <b>--debuglevel=<c>verblevel</c></b>: Controls the level of verbosity for
95 + <b>--loglevel=<c>verblevel</c></b>: Controls the level of verbosity for
96 information provided by genkernel. The variable <c>verblevel</c> is an
97 integer between 0 and 5. The level '0' represents minimal output, while '5'
98 provides as much information as possible about genkernel's activities
99 during the kernel compilation process.
100 </li>
101 <li>
102 - <b>--debugfile=<path>/path/to/outputfile</path></b>: Ignores the value set
103 - by the <c>--debuglevel</c> argument, and sends <b>all</b> debugging data
104 + <b>--logfile=<path>/path/to/outputfile</path></b>: Ignores the value set
105 + by the <c>--loglevel</c> argument, and sends <b>all</b> debugging data
106 produced by genkernel to the specified output file, which is located at
107 <path>/var/log/genkernel.log</path> by default.
108 </li>
109 @@ -561,7 +569,7 @@
110 </p>
111
112 <pre caption="Running genkernel (overloaded with flags)">
113 -# <i>genkernel --debuglevel=5 --no-color --no-mrproper --clean --splash \
114 +# <i>genkernel --loglevel=5 --no-color --no-mrproper --clean --splash \
115 --kerneldir=/path/to/alternate/kernel/sources --install --menuconfig \
116 --kernel-config=/path/to/preferred/configfile --save-config --mountboot all</i>
117 </pre>
118 @@ -619,10 +627,10 @@
119 debugging (when needed.)
120 </li>
121 <li>
122 - <b>DEBUGLEVEL=<c>[0|1|2|3|4|5]</c></b>: This option is for adjusting the
123 + <b>LOGLEVEL=<c>[0|1|2|3|4|5]</c></b>: This option is for adjusting the
124 verbosity of the output produced by genkernel &mdash; setting this option to
125 - '0' with <c>--debuglevel=0</c> will suppress all output produced by
126 - genkernel; setting this option to '5' with <c>--debuglevel=5</c> provides
127 + '0' with <c>--loglevel=0</c> will suppress all output produced by
128 + genkernel; setting this option to '5' with <c>--loglevel=5</c> provides
129 the user with all output produced by genkernel.
130 </li>
131 </ul>
132 @@ -871,5 +879,4 @@
133 </body>
134 </section>
135 </chapter>
136 -
137 </guide>