1 |
neysx 05/08/18 11:33:54 |
2 |
|
3 |
Modified: xml/htdocs/doc/en genkernel.xml |
4 |
Log: |
5 |
#102877: Fixed coding style including prompts and <i> in <pre> elements |
6 |
No content change |
7 |
|
8 |
Revision Changes Path |
9 |
1.23 +354 -380 xml/htdocs/doc/en/genkernel.xml |
10 |
|
11 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/genkernel.xml?rev=1.23&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
12 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/genkernel.xml?rev=1.23&content-type=text/plain&cvsroot=gentoo |
13 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/genkernel.xml.diff?r1=1.22&r2=1.23&cvsroot=gentoo |
14 |
|
15 |
Index: genkernel.xml |
16 |
=================================================================== |
17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v |
18 |
retrieving revision 1.22 |
19 |
retrieving revision 1.23 |
20 |
diff -u -r1.22 -r1.23 |
21 |
--- genkernel.xml 11 Aug 2005 09:59:36 -0000 1.22 |
22 |
+++ genkernel.xml 18 Aug 2005 11:33:54 -0000 1.23 |
23 |
@@ -1,5 +1,5 @@ |
24 |
<?xml version='1.0' encoding="UTF-8"?> |
25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.22 2005/08/11 09:59:36 plasmaroo Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/genkernel.xml,v 1.23 2005/08/18 11:33:54 neysx Exp $ --> |
27 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
28 |
|
29 |
<guide link="/doc/en/genkernel.xml"> |
30 |
@@ -48,7 +48,6 @@ |
31 |
|
32 |
</body> |
33 |
</section> |
34 |
- |
35 |
<section> |
36 |
<title>Target Audience</title> |
37 |
<body> |
38 |
@@ -77,13 +76,13 @@ |
39 |
|
40 |
<p> |
41 |
To obtain genkernel, run <c>emerge genkernel</c> from the command line. If you |
42 |
-are using the |
43 |
-<uri link="http://www.gentoo.org/doc/en/handbook/2005.0/hb-install-about.xml#doc_chap2_sect1"> |
44 |
-Gentoo Reference Platform</uri> (GRP), remember to install binary packages by |
45 |
-passing the <c>-k</c> flag to emerge. Since the GRP is bundled with an older |
46 |
-version of genkernel, the flags may be different. In any case, consult |
47 |
-<c>genkernel --help</c> for help on how to use the version of genkernel |
48 |
-installed on your system. |
49 |
+are using the <uri |
50 |
+link="/doc/en/handbook/2005.0/hb-install-about.xml#doc_chap2_sect1"> Gentoo |
51 |
+Reference Platform</uri> (GRP), remember to install binary packages by passing |
52 |
+the <c>-k</c> flag to emerge. Since the GRP is bundled with an older version of |
53 |
+genkernel, the flags may be different. In any case, consult <c>genkernel |
54 |
+--help</c> for help on how to use the version of genkernel installed on your |
55 |
+system. |
56 |
</p> |
57 |
|
58 |
</body> |
59 |
@@ -106,7 +105,7 @@ |
60 |
</p> |
61 |
|
62 |
<pre caption="Running genkernel (with flags)"> |
63 |
-# genkernel --bootsplash --no-install --no-clean --menuconfig all |
64 |
+# <i>genkernel --bootsplash --no-install --no-clean --menuconfig all</i> |
65 |
</pre> |
66 |
|
67 |
<p> |
68 |
@@ -159,37 +158,36 @@ |
69 |
</p> |
70 |
|
71 |
<ul> |
72 |
- <li> |
73 |
- <b>--<c>no-</c>menuconfig</b>: Activates <e>[or deactivates]</e> the |
74 |
- <c>make menuconfig</c> command (which invokes an interactive, menu-based |
75 |
- kernel configuration utility), before building the kernel. |
76 |
- </li> |
77 |
- <li> |
78 |
- <b>--gconfig</b>: Provides a kernel configuration utility which depends |
79 |
- on the GTK+ libraries. The advantage of this option is that most users |
80 |
- find it easier and clearer to configure the kernel using this tool, since |
81 |
- it relies on the X-windowing system. The disadvantage of this option is |
82 |
- that you <b>need</b> the X-windowing system to use it, so it will not |
83 |
- work on the command line. |
84 |
- </li> |
85 |
- <li> |
86 |
- <b>--xconfig</b>: Provides a kernel configuration utility which depends |
87 |
- on the QT libraries. The advantage of this option is that most users find |
88 |
- it easier and clearer to configure the kernel using this tool, since it |
89 |
- relies on the X-windowing system. The disadvantage of this option is that |
90 |
- you <b>need</b> the X-windowing system to use it, so it will not work on |
91 |
- the command line. |
92 |
- </li> |
93 |
- <li> |
94 |
- <b>--<c>no-</c>save-config</b>: Saves [or does not save] the kernel |
95 |
- configuration to a file in the <path>/etc/kernels/</path> directory for |
96 |
- later use. |
97 |
- </li> |
98 |
+ <li> |
99 |
+ <b>--<c>no-</c>menuconfig</b>: Activates <e>[or deactivates]</e> the |
100 |
+ <c>make menuconfig</c> command (which invokes an interactive, menu-based |
101 |
+ kernel configuration utility), before building the kernel. |
102 |
+ </li> |
103 |
+ <li> |
104 |
+ <b>--gconfig</b>: Provides a kernel configuration utility which depends on |
105 |
+ the GTK+ libraries. The advantage of this option is that most users find it |
106 |
+ easier and clearer to configure the kernel using this tool, since it relies |
107 |
+ on the X-windowing system. The disadvantage of this option is that you |
108 |
+ <b>need</b> the X-windowing system to use it, so it will not work on the |
109 |
+ command line. |
110 |
+ </li> |
111 |
+ <li> |
112 |
+ <b>--xconfig</b>: Provides a kernel configuration utility which depends on |
113 |
+ the QT libraries. The advantage of this option is that most users find it |
114 |
+ easier and clearer to configure the kernel using this tool, since it relies |
115 |
+ on the X-windowing system. The disadvantage of this option is that you |
116 |
+ <b>need</b> the X-windowing system to use it, so it will not work on the |
117 |
+ command line. |
118 |
+ </li> |
119 |
+ <li> |
120 |
+ <b>--<c>no-</c>save-config</b>: Saves [or does not save] the kernel |
121 |
+ configuration to a file in the <path>/etc/kernels/</path> directory for |
122 |
+ later use. |
123 |
+ </li> |
124 |
</ul> |
125 |
|
126 |
</body> |
127 |
</section> |
128 |
- |
129 |
<section> |
130 |
<title>Compilation Flags</title> |
131 |
<body> |
132 |
@@ -200,8 +198,8 @@ |
133 |
|
134 |
<ul> |
135 |
<li> |
136 |
- <b>--kerneldir=<path>/path/to/sources/</path></b>: Specifies an |
137 |
- alternative kernel source location, rather than the default |
138 |
+ <b>--kerneldir=<path>/path/to/sources/</path></b>: Specifies an alternative |
139 |
+ kernel source location, rather than the default |
140 |
<path>/usr/src/linux/</path> location. |
141 |
</li> |
142 |
<li> |
143 |
@@ -210,72 +208,70 @@ |
144 |
<path>/path/to/sources/.config</path> file. |
145 |
</li> |
146 |
<li> |
147 |
- <b>--module-prefix=<path>/path/to/prefix-directory/</path></b>: Specifies |
148 |
- a prefix to the directory where kernel modules will be installed (default |
149 |
+ <b>--module-prefix=<path>/path/to/prefix-directory/</path></b>: Specifies a |
150 |
+ prefix to the directory where kernel modules will be installed (default |
151 |
path is the <path>/lib/modules/</path> directory.) |
152 |
</li> |
153 |
</ul> |
154 |
|
155 |
<ul> |
156 |
<li> |
157 |
- <b>--<c>no-</c>clean</b>: Activates <e>[or deactivates]</e> the |
158 |
- <c>make clean</c> command before compiling your kernel. The |
159 |
- <c>make clean</c> command removes all object files and dependencies from |
160 |
- the kernel's source tree. |
161 |
+ <b>--<c>no-</c>clean</b>: Activates <e>[or deactivates]</e> the <c>make |
162 |
+ clean</c> command before compiling your kernel. The <c>make clean</c> |
163 |
+ command removes all object files and dependencies from the kernel's source |
164 |
+ tree. |
165 |
</li> |
166 |
<li> |
167 |
- <b>--<c>no-</c>mrproper</b>: Activates <e>[or deactivates]</e> the |
168 |
- <c>make mrproper</c> command before kernel compilation. Like the |
169 |
- <c>make clean</c> command, <c>make mrproper</c> removes all object files |
170 |
- and dependencies from the kernel's source tree. However, any previous |
171 |
- configuration files (in <path>/path/to/sources/.config</path> or |
172 |
- <path>/path/to/sources/.config.old</path>) will <b>also</b> be purged |
173 |
- from the kernel's source tree. |
174 |
+ <b>--<c>no-</c>mrproper</b>: Activates <e>[or deactivates]</e> the <c>make |
175 |
+ mrproper</c> command before kernel compilation. Like the <c>make clean</c> |
176 |
+ command, <c>make mrproper</c> removes all object files and dependencies |
177 |
+ from the kernel's source tree. However, any previous configuration files |
178 |
+ (in <path>/path/to/sources/.config</path> or |
179 |
+ <path>/path/to/sources/.config.old</path>) will <b>also</b> be purged from |
180 |
+ the kernel's source tree. |
181 |
</li> |
182 |
<li> |
183 |
<b>--oldconfig</b>: Issues the <c>make oldconfig</c> command, which |
184 |
- attempts to collect configuration information for the system's |
185 |
- architecture from a generic script in <path>/usr/share/genkernel/</path>. |
186 |
- This is a non-interactive process; no user input is entertained. Also, if |
187 |
+ attempts to collect configuration information for the system's architecture |
188 |
+ from a generic script in <path>/usr/share/genkernel/</path>. This is a |
189 |
+ non-interactive process; no user input is entertained. Also, if |
190 |
<c>--oldconfig</c> is used in conjunction with <c>--clean</c>, the latter |
191 |
- flag is negated, resulting in the activation of the <c>--no-clean</c> |
192 |
- flag. |
193 |
+ flag is negated, resulting in the activation of the <c>--no-clean</c> flag. |
194 |
</li> |
195 |
</ul> |
196 |
|
197 |
<ul> |
198 |
- <li> |
199 |
- <b>--callback="<c>echo hello</c>"</b>: Calls the specified arguments |
200 |
- (<c>echo hello</c>, in this case) after the kernel and the relevant |
201 |
- modules have been built, but before building the initrd image. This may |
202 |
- be useful if you want to install external modules in the initrd image by |
203 |
- emerging the relevant item(s) with the callback feature, and then |
204 |
- redefining a genkernel module group. |
205 |
- </li> |
206 |
+ <li> |
207 |
+ <b>--callback="<c>echo hello</c>"</b>: Calls the specified arguments |
208 |
+ (<c>echo hello</c>, in this case) after the kernel and the relevant modules |
209 |
+ have been built, but before building the initrd image. This may be useful |
210 |
+ if you want to install external modules in the initrd image by emerging the |
211 |
+ relevant item(s) with the callback feature, and then redefining a genkernel |
212 |
+ module group. |
213 |
+ </li> |
214 |
|
215 |
|
216 |
|
217 |
-- |
218 |
gentoo-doc-cvs@g.o mailing list |