1 |
commit: 5b36ad3da40e4e01f45b3eec56642f20ef7e7217 |
2 |
Author: Robin H. Johnson <robbat2 <AT> gentoo <DOT> org> |
3 |
AuthorDate: Tue Jan 3 04:38:02 2017 +0000 |
4 |
Commit: Robin H. Johnson <robbat2 <AT> gentoo <DOT> org> |
5 |
CommitDate: Tue Jan 3 04:38:02 2017 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/genkernel.git/commit/?id=5b36ad3d |
7 |
|
8 |
doc: cleanup manpage |
9 |
|
10 |
Cleanup the manpage formatting, and include some minor wording |
11 |
improvements as suggested by <aaronf0 <AT> gmail.com>. |
12 |
|
13 |
Fixes: https://bugs.gentoo.org/show_bug.cgi?id=452746 |
14 |
Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org> |
15 |
|
16 |
doc/genkernel.8.txt | 93 ++++++++++++++++++++++++++++++----------------------- |
17 |
1 file changed, 52 insertions(+), 41 deletions(-) |
18 |
|
19 |
diff --git a/doc/genkernel.8.txt b/doc/genkernel.8.txt |
20 |
index d39c3ca..a2d3c22 100644 |
21 |
--- a/doc/genkernel.8.txt |
22 |
+++ b/doc/genkernel.8.txt |
23 |
@@ -144,7 +144,8 @@ KERNEL COMPILATION |
24 |
*--install* is also specified. |
25 |
|
26 |
*--oldconfig*:: |
27 |
- Implies *--no-clean*, and thus *--no-mrproper*, running a "make oldconfig". |
28 |
+ Implies *--no-clean*, and thus *--no-mrproper*, running a |
29 |
+ "make oldconfig". |
30 |
|
31 |
*--*[*no-*]*splash*:: |
32 |
Installs, or not, framebuffer splash support into initramfs. |
33 |
@@ -160,8 +161,8 @@ KERNEL COMPILATION |
34 |
kernel and modules have been compiled. |
35 |
|
36 |
*--*[*no-*]*static*:: |
37 |
- Builds, or does not build a monolithic kernel without any modules on any |
38 |
- initial ramdisks. |
39 |
+ Builds, or does not build a monolithic kernel without any modules on |
40 |
+ any initial ramdisks. |
41 |
|
42 |
|
43 |
KERNEL LOCATIONS |
44 |
@@ -206,11 +207,11 @@ LOW-LEVEL COMPILATION OPTIONS |
45 |
*--kernel-binary*=<path>:: |
46 |
Override default kernel binary path (arch/foo/boot/bar) |
47 |
|
48 |
-*--kernel-outputdir=<path>:: |
49 |
- Save output files outside the source tree. This should be used rather than |
50 |
- KBUILD_OUTPUT when you wish to place kernel objects outside of the source |
51 |
- tree (eg because cannot write to that directory as the user genkernel is |
52 |
- running as). |
53 |
+*--kernel-outputdir*=<path>:: |
54 |
+ Save output files outside the source tree. This should be used rather than |
55 |
+ KBUILD_OUTPUT when you wish to place kernel objects outside of the source |
56 |
+ tree (eg because cannot write to that directory as the user genkernel is |
57 |
+ running as). |
58 |
|
59 |
*--utils-cc*=<compiler>:: |
60 |
Compiler to use for utilities. |
61 |
@@ -243,8 +244,8 @@ LOW-LEVEL COMPILATION OPTIONS |
62 |
GNU Make options such as -j2, etc. |
63 |
|
64 |
*--*[*no-*]*nice*[=<niceness>]:: |
65 |
- Runs the kernel make at the default niceness (reduction in priority) of |
66 |
- 10, or in the case of --no-nice, runs the kernel make at normal priority. |
67 |
+ Runs the kernel make at the default niceness (reduction in priority) of |
68 |
+ 10, or in the case of --no-nice, runs the kernel make at normal priority. |
69 |
|
70 |
INITIALIZATION |
71 |
~~~~~~~~~~~~~~ |
72 |
@@ -266,8 +267,8 @@ INITIALIZATION |
73 |
Enables or disables keymap selection at boot. |
74 |
|
75 |
*--*[*no-*]*lvm*:: |
76 |
- Adds or skips in LVM support from static binaries if they exist on the |
77 |
- system, or compile static LVM binaries if static ones do not exist. |
78 |
+ Adds or skips in LVM support from static binaries if they exist on the |
79 |
+ system, or compile static LVM binaries if static ones do not exist. |
80 |
|
81 |
*--*[*no-*]*mdadm*:: |
82 |
Includes or excludes mdadm/mdmon support. |
83 |
@@ -312,18 +313,18 @@ INITIALIZATION |
84 |
Specifies a user created busybox config. |
85 |
|
86 |
*--genzimage*:: |
87 |
- Make and install kernelz image from 'arch/powerpc/boot/zImage.initrd'. |
88 |
+ Make and install kernelz image from 'arch/powerpc/boot/zImage.initrd'. |
89 |
|
90 |
*--*[*no-*]*disklabel*:: |
91 |
Includes or excludes disk label and uuid support in your initrd. |
92 |
|
93 |
*--*[*no-*]*luks*:: |
94 |
- Includes or excludes Luks support from static binaries if they exist on |
95 |
- the system. |
96 |
+ Includes or excludes Luks support from static binaries if they exist on |
97 |
+ the system. |
98 |
|
99 |
*--*[*no-*]*gpg*:: |
100 |
- Includes or excludes support for GnuPG 1.x, the portable standalone branch |
101 |
- of GnuPG. A key can be made from |
102 |
+ Includes or excludes support for GnuPG 1.x, the portable standalone branch |
103 |
+ of GnuPG. A key can be made from |
104 |
`gpg --symmetric -o /path/to/LUKS-key.gpg /path/to/LUKS-key` . |
105 |
After that, re-point the *root_key* argument to the new .gpg file. |
106 |
|
107 |
@@ -353,7 +354,7 @@ INTERNALS |
108 |
Sets genkernel's temporary working directory to <dir>. |
109 |
|
110 |
*--*[*no-*]*postclear*:: |
111 |
- Clears or skips clearing all tmp files and caches after genkernel has run. |
112 |
+ Clears or skips clearing all tmp files and caches after genkernel has run. |
113 |
|
114 |
|
115 |
OUTPUT SETTINGS |
116 |
@@ -395,30 +396,36 @@ OUTPUT SETTINGS |
117 |
|
118 |
*--*[*no-*]*firmware-install*:: |
119 |
Enable or disables installation of firmware onto root filesystem. |
120 |
- Installing sys-kernel/linux-firmware should be preferred instead. |
121 |
+ Please note this is deprecated, and installing |
122 |
+ *sys-kernel/linux-firmware* should be preferred instead. |
123 |
|
124 |
*--*[*no-*]*integrated-initramfs*:: |
125 |
- Builds or does not build the generated initramfs into the kernel instead |
126 |
- of keeping it as a separate file. |
127 |
+ Builds or does not build the generated initramfs into the kernel instead |
128 |
+ of keeping it as a separate file. |
129 |
|
130 |
*--*[*no-*]*wrap-initrd*:: |
131 |
- Wrap initramfs using mkimage for u-boot boots. Please note that only |
132 |
- certain compression types are supported by mkimage (see manpage). |
133 |
- |
134 |
+ Wrap initramfs using mkimage for u-boot boots. Please note that only |
135 |
+ certain compression types are supported by mkimage (see manpage). |
136 |
|
137 |
*--*[*no-*]*compress-initramfs*, *--*[*no-*]*compress-initrd*:: |
138 |
- Compresses or does not compress the generated initramfs. |
139 |
+ Compresses or does not compress the generated initramfs. |
140 |
|
141 |
*--compress-initramfs-type*=<arg>:: |
142 |
- Compression type for initramfs (best, xz, lzma, bzip2, gzip, lzop). |
143 |
- "Best" causes selection of the best available algorithm that is selected |
144 |
- in your kernel configuration. |
145 |
+ Compression type for initramfs (best, xz, lzma, bzip2, gzip, lzop). |
146 |
+ "Best" causes selection of the best available algorithm that is selected |
147 |
+ in your kernel configuration. |
148 |
|
149 |
|
150 |
RAMDISK/INITRAMFS OPTIONS |
151 |
------------------------- |
152 |
-The following options can be passed as kernel parameters from the bootloader, |
153 |
-which the ramdisk & initramfs scripts would recognize. |
154 |
+The following options are some of those available to be passed as kernel |
155 |
+parameters from the bootloader. Genkernel will not handle this |
156 |
+operation, please refer to your bootloader documentation for a more |
157 |
+complete description of each. |
158 |
+ |
159 |
+This listing is intended to cover most of the options recognized by the |
160 |
+ramdisk/initramfs scripts, as well as some of the common options |
161 |
+recognized by the kernel itself. |
162 |
|
163 |
*root*=<...>:: |
164 |
Specifies the device node of the root filesystem to mount. |
165 |
@@ -479,8 +486,8 @@ which the ramdisk & initramfs scripts would recognize. |
166 |
|
167 |
*rootdelay*[=<...>]:: |
168 |
*rootwait*[=<...>]:: |
169 |
- Pauses for up to 3 seconds (or specified number of seconds) while |
170 |
- waiting for root device to appear during initramfs root scanning. |
171 |
+ Pauses for up to 3 seconds (or specified number of seconds) while |
172 |
+ waiting for root device to appear during initramfs root scanning. |
173 |
|
174 |
*ip*=<...>:: |
175 |
Normally used to tell the kernel that it should start a network |
176 |
@@ -565,8 +572,8 @@ which the ramdisk & initramfs scripts would recognize. |
177 |
|
178 |
*part*[=<0,1>]:: |
179 |
*partitionable*:: |
180 |
- Enable/Disable partitionable RAIDs (metadata 0.x) during auto-run. |
181 |
- Standalone *part* and *partitionable* keywords for kernel compatability. |
182 |
+ Enable/Disable partitionable RAIDs (metadata 0.x) during auto-run. |
183 |
+ Standalone *part* and *partitionable* keywords for kernel compatability. |
184 |
|
185 |
*iscsi_initiatorname*=<...>:: |
186 |
*iscsi_target*=<...>:: |
187 |
@@ -630,8 +637,8 @@ NETBOOTING |
188 |
---------- |
189 |
The initrd scripts have limited support for network booting. This is |
190 |
activated if the *ip*=<...> kernel parameter was given. Please refer to |
191 |
-the genkernel guide at 'http://www.gentoo.org/doc/en/genkernel.xml' for |
192 |
-more information. |
193 |
+the genkernel guide at 'https://wiki.gentoo.org/wiki/Genkernel' for more |
194 |
+information. |
195 |
|
196 |
The initrd scripts will extract any *.tar.gz files found in the '/add' |
197 |
directory of the livecd into the root filesystem during boot. This way |
198 |
@@ -650,14 +657,15 @@ If you're somewhat unsure if you hit a bug or not, file a bug an we'll find out |
199 |
For general questions the is the gentoo-genkernel mailing list. You can join the list |
200 |
by sending empty mail to 'gentoo-genkernel+subscribe@l.g.o'. |
201 |
|
202 |
-We cannot assist you with |
203 |
-kernel compilation failures unless they are caused by a genkernel bug. |
204 |
+We cannot assist you with kernel compilation failures unless they are |
205 |
+caused by a genkernel bug. |
206 |
|
207 |
Kernel issues for Gentoo-supported kernels, including compilation failures |
208 |
should go to 'https://bugs.gentoo.org/' and should be assigned to 'kernel@g.o'. |
209 |
-Please check if an existing bug documents the same |
210 |
-issue before opening a new bug. Issues for kernel sources not supported |
211 |
-by Gentoo should go to their relevant authors. |
212 |
+ |
213 |
+Please check if an existing bug documents the same issue before opening |
214 |
+a new bug. Issues for kernel sources not supported by Gentoo should go |
215 |
+to their relevant authors. |
216 |
|
217 |
|
218 |
AUTHORS |
219 |
@@ -666,6 +674,7 @@ AUTHORS |
220 |
- Eric Edgar <rocket@g.o> |
221 |
- Chris Gianelloni <wolf31o2@g.o> |
222 |
- Sebastian Pipping <sebastian@×××××××.org> |
223 |
+- Robin H. Johnson <robbat2@g.o> |
224 |
- NFS Support by Thomas Seiler <thseiler@×××××.com> |
225 |
- GnuPG 1.x integration by dacook <schism@×××××××××.org> |
226 |
- MDADM integration by Matthias Dahl <ua_bugz_gentoo@×××××××××××.de> |
227 |
@@ -675,3 +684,5 @@ AUTHORS |
228 |
SEE ALSO |
229 |
-------- |
230 |
/etc/genkernel.conf - genkernel configuration file |
231 |
+ |
232 |
+// vim: ft=asciidoc et tw=72 sts=4 ts=4 : |