Commit 88f7a642cf0d6bdfa789593ba2b019ca940a3a72
Committed by
Jiri Kosina
1 parent
6d12760c9f
Exists in
master
and in
20 other branches
README: More consistent and readable white space
Mainly, this just separates paragraphs, so that the text is easier on the eyes. Signed-off-by: Michael Witten <mfwitten@gmail.com> Acked-by: Randy Dunlap <rdunlap@xenotime.net> Signed-off-by: Jiri Kosina <jkosina@suse.cz>
Showing 1 changed file with 31 additions and 10 deletions Side-by-side Diff
README
... | ... | @@ -65,9 +65,9 @@ |
65 | 65 | gzip -cd linux-3.X.tar.gz | tar xvf - |
66 | 66 | |
67 | 67 | or |
68 | + | |
68 | 69 | bzip2 -dc linux-3.X.tar.bz2 | tar xvf - |
69 | 70 | |
70 | - | |
71 | 71 | Replace "X" with the version number of the latest kernel. |
72 | 72 | |
73 | 73 | Do NOT use the /usr/src/linux area! This area has a (usually |
... | ... | @@ -83,6 +83,7 @@ |
83 | 83 | gzip -cd ../patch-3.x.gz | patch -p1 |
84 | 84 | |
85 | 85 | or |
86 | + | |
86 | 87 | bzip2 -dc ../patch-3.x.bz2 | patch -p1 |
87 | 88 | |
88 | 89 | Replace "x" for all versions bigger than the version "X" of your current |
89 | 90 | |
90 | 91 | |
... | ... | @@ -142,15 +143,17 @@ |
142 | 143 | Using the option "make O=output/dir" allow you to specify an alternate |
143 | 144 | place for the output files (including .config). |
144 | 145 | Example: |
146 | + | |
145 | 147 | kernel source code: /usr/src/linux-3.X |
146 | 148 | build directory: /home/name/build/kernel |
147 | 149 | |
148 | 150 | To configure and build the kernel, use: |
149 | - cd /usr/src/linux-3.X | |
150 | - make O=/home/name/build/kernel menuconfig | |
151 | - make O=/home/name/build/kernel | |
152 | - sudo make O=/home/name/build/kernel modules_install install | |
153 | 151 | |
152 | + cd /usr/src/linux-3.X | |
153 | + make O=/home/name/build/kernel menuconfig | |
154 | + make O=/home/name/build/kernel | |
155 | + sudo make O=/home/name/build/kernel modules_install install | |
156 | + | |
154 | 157 | Please note: If the 'O=output/dir' option is used, then it must be |
155 | 158 | used for all invocations of make. |
156 | 159 | |
157 | 160 | |
158 | 161 | |
159 | 162 | |
160 | 163 | |
161 | 164 | |
162 | 165 | |
163 | 166 | |
164 | 167 | |
165 | 168 | |
166 | 169 | |
167 | 170 | |
168 | 171 | |
... | ... | @@ -164,36 +167,49 @@ |
164 | 167 | only ask you for the answers to new questions. |
165 | 168 | |
166 | 169 | - Alternative configuration commands are: |
170 | + | |
167 | 171 | "make config" Plain text interface. |
172 | + | |
168 | 173 | "make menuconfig" Text based color menus, radiolists & dialogs. |
174 | + | |
169 | 175 | "make nconfig" Enhanced text based color menus. |
176 | + | |
170 | 177 | "make xconfig" X windows (Qt) based configuration tool. |
178 | + | |
171 | 179 | "make gconfig" X windows (Gtk) based configuration tool. |
180 | + | |
172 | 181 | "make oldconfig" Default all questions based on the contents of |
173 | 182 | your existing ./.config file and asking about |
174 | 183 | new config symbols. |
184 | + | |
175 | 185 | "make silentoldconfig" |
176 | 186 | Like above, but avoids cluttering the screen |
177 | 187 | with questions already answered. |
178 | 188 | Additionally updates the dependencies. |
189 | + | |
179 | 190 | "make defconfig" Create a ./.config file by using the default |
180 | 191 | symbol values from either arch/$ARCH/defconfig |
181 | 192 | or arch/$ARCH/configs/${PLATFORM}_defconfig, |
182 | 193 | depending on the architecture. |
194 | + | |
183 | 195 | "make ${PLATFORM}_defconfig" |
184 | - Create a ./.config file by using the default | |
185 | - symbol values from | |
186 | - arch/$ARCH/configs/${PLATFORM}_defconfig. | |
187 | - Use "make help" to get a list of all available | |
188 | - platforms of your architecture. | |
196 | + Create a ./.config file by using the default | |
197 | + symbol values from | |
198 | + arch/$ARCH/configs/${PLATFORM}_defconfig. | |
199 | + Use "make help" to get a list of all available | |
200 | + platforms of your architecture. | |
201 | + | |
189 | 202 | "make allyesconfig" |
190 | 203 | Create a ./.config file by setting symbol |
191 | 204 | values to 'y' as much as possible. |
205 | + | |
192 | 206 | "make allmodconfig" |
193 | 207 | Create a ./.config file by setting symbol |
194 | 208 | values to 'm' as much as possible. |
209 | + | |
195 | 210 | "make allnoconfig" Create a ./.config file by setting symbol |
196 | 211 | values to 'n' as much as possible. |
212 | + | |
197 | 213 | "make randconfig" Create a ./.config file by setting symbol |
198 | 214 | values to random values. |
199 | 215 | |
200 | 216 | |
201 | 217 | |
202 | 218 | |
... | ... | @@ -201,17 +217,21 @@ |
201 | 217 | in Documentation/kbuild/kconfig.txt. |
202 | 218 | |
203 | 219 | NOTES on "make config": |
220 | + | |
204 | 221 | - having unnecessary drivers will make the kernel bigger, and can |
205 | 222 | under some circumstances lead to problems: probing for a |
206 | 223 | nonexistent controller card may confuse your other controllers |
224 | + | |
207 | 225 | - compiling the kernel with "Processor type" set higher than 386 |
208 | 226 | will result in a kernel that does NOT work on a 386. The |
209 | 227 | kernel will detect this on bootup, and give up. |
228 | + | |
210 | 229 | - A kernel with math-emulation compiled in will still use the |
211 | 230 | coprocessor if one is present: the math emulation will just |
212 | 231 | never get used in that case. The kernel will be slightly larger, |
213 | 232 | but will work on different machines regardless of whether they |
214 | 233 | have a math coprocessor or not. |
234 | + | |
215 | 235 | - the "kernel hacking" configuration details usually result in a |
216 | 236 | bigger or slower kernel (or both), and can even make the kernel |
217 | 237 | less stable by configuring some routines to actively try to |
... | ... | @@ -256,6 +276,7 @@ |
256 | 276 | are installing a new kernel with the same version number as your |
257 | 277 | working kernel, make a backup of your modules directory before you |
258 | 278 | do a "make modules_install". |
279 | + | |
259 | 280 | Alternatively, before compiling, use the kernel config option |
260 | 281 | "LOCALVERSION" to append a unique suffix to the regular kernel version. |
261 | 282 | LOCALVERSION can be set in the "General Setup" menu. |