Skip to content

Commit

Permalink
README: More consistent and readable white space
Browse files Browse the repository at this point in the history
Mainly, this just separates paragraphs, so that the text is easier
on the eyes.

Signed-off-by: Michael Witten <[email protected]>
Acked-by: Randy Dunlap <[email protected]>
Signed-off-by: Jiri Kosina <[email protected]>
  • Loading branch information
mfwitten authored and Jiri Kosina committed Apr 17, 2012
1 parent 6d12760 commit 88f7a64
Showing 1 changed file with 31 additions and 10 deletions.
41 changes: 31 additions & 10 deletions README
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,8 @@ INSTALLING the kernel source:
gzip -cd linux-3.X.tar.gz | tar xvf -

or
bzip2 -dc linux-3.X.tar.bz2 | tar xvf -

bzip2 -dc linux-3.X.tar.bz2 | tar xvf -

Replace "X" with the version number of the latest kernel.

Expand All @@ -83,6 +83,7 @@ INSTALLING the kernel source:
gzip -cd ../patch-3.x.gz | patch -p1

or

bzip2 -dc ../patch-3.x.bz2 | patch -p1

Replace "x" for all versions bigger than the version "X" of your current
Expand Down Expand Up @@ -142,14 +143,16 @@ BUILD directory for the kernel:
Using the option "make O=output/dir" allow you to specify an alternate
place for the output files (including .config).
Example:

kernel source code: /usr/src/linux-3.X
build directory: /home/name/build/kernel

To configure and build the kernel, use:
cd /usr/src/linux-3.X
make O=/home/name/build/kernel menuconfig
make O=/home/name/build/kernel
sudo make O=/home/name/build/kernel modules_install install

cd /usr/src/linux-3.X
make O=/home/name/build/kernel menuconfig
make O=/home/name/build/kernel
sudo make O=/home/name/build/kernel modules_install install

Please note: If the 'O=output/dir' option is used, then it must be
used for all invocations of make.
Expand All @@ -164,54 +167,71 @@ CONFIGURING the kernel:
only ask you for the answers to new questions.

- Alternative configuration commands are:

"make config" Plain text interface.

"make menuconfig" Text based color menus, radiolists & dialogs.

"make nconfig" Enhanced text based color menus.

"make xconfig" X windows (Qt) based configuration tool.

"make gconfig" X windows (Gtk) based configuration tool.

"make oldconfig" Default all questions based on the contents of
your existing ./.config file and asking about
new config symbols.

"make silentoldconfig"
Like above, but avoids cluttering the screen
with questions already answered.
Additionally updates the dependencies.

"make defconfig" Create a ./.config file by using the default
symbol values from either arch/$ARCH/defconfig
or arch/$ARCH/configs/${PLATFORM}_defconfig,
depending on the architecture.

"make ${PLATFORM}_defconfig"
Create a ./.config file by using the default
symbol values from
arch/$ARCH/configs/${PLATFORM}_defconfig.
Use "make help" to get a list of all available
platforms of your architecture.
Create a ./.config file by using the default
symbol values from
arch/$ARCH/configs/${PLATFORM}_defconfig.
Use "make help" to get a list of all available
platforms of your architecture.

"make allyesconfig"
Create a ./.config file by setting symbol
values to 'y' as much as possible.

"make allmodconfig"
Create a ./.config file by setting symbol
values to 'm' as much as possible.

"make allnoconfig" Create a ./.config file by setting symbol
values to 'n' as much as possible.

"make randconfig" Create a ./.config file by setting symbol
values to random values.

You can find more information on using the Linux kernel config tools
in Documentation/kbuild/kconfig.txt.

NOTES on "make config":

- having unnecessary drivers will make the kernel bigger, and can
under some circumstances lead to problems: probing for a
nonexistent controller card may confuse your other controllers

- compiling the kernel with "Processor type" set higher than 386
will result in a kernel that does NOT work on a 386. The
kernel will detect this on bootup, and give up.

- A kernel with math-emulation compiled in will still use the
coprocessor if one is present: the math emulation will just
never get used in that case. The kernel will be slightly larger,
but will work on different machines regardless of whether they
have a math coprocessor or not.

- the "kernel hacking" configuration details usually result in a
bigger or slower kernel (or both), and can even make the kernel
less stable by configuring some routines to actively try to
Expand Down Expand Up @@ -256,6 +276,7 @@ COMPILING the kernel:
are installing a new kernel with the same version number as your
working kernel, make a backup of your modules directory before you
do a "make modules_install".

Alternatively, before compiling, use the kernel config option
"LOCALVERSION" to append a unique suffix to the regular kernel version.
LOCALVERSION can be set in the "General Setup" menu.
Expand Down

0 comments on commit 88f7a64

Please sign in to comment.