Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: genkernel.xml
Date: Thu, 18 Aug 2005 11:34:12
Message-Id: 200508181133.j7IBX45I023783@robin.gentoo.org
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