Commit 88f7a642cf0d6bdfa789593ba2b019ca940a3a72

Authored by Michael Witten
Committed by Jiri Kosina
1 parent 6d12760c9f

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

... ... @@ -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.