

             Short Installation Guide for menuconfig(kmenu-0.8)

If this is too complicated or you really want an install script, please mail
me.

You probably should have read the kernel-HOWTO before you do this, especially
when you have only little or no practice in kernel configuration and patching.

The kernel-howto is on sunsite.unc.edu and it's mirrors under
pub/Linux/doc/howto. There are many versions in different formats.

1.) Go to the top of your linux kernel source tree (/usr/src/linux).

	Eg: cd /usr/src/linux

2.) If the directory "scripts" doesn't already exist, create it there.

	Eg: mkdir scripts

3.) Place the files Configure.menu and Configure.menu.awkfrom this
    package into the scripts directory.

    	Eg: cp ../kmenu-0.8/Configure.menu scripts
    	Eg: cp ../kmenu-0.8/Configure.menu.awk scripts

4.) If you use linux-1.3.47 or newer skip this, you have the full
    kernel config help texts support already!

    If you want to use Axel Boldt's kernel config help texts not only with
    menuconfig and xconfig, but also with the standard config, install
    his package before mine, and apply my changes to Confgure by hand
    if they would not apply automatically in this case. Insert step 7
    and 8 here, if you want it.

    Patch the Makefile and the config.in files. If you patch a 1.2 or 1.1
    series kernel use the file kmenu-1.2.10.patch, if you patch a
    1.3 series kernel, use the file kmenu-1.3.30.patch from this
    distribution. If your kernel is 1.3.35 or over you need only
    the small patch in kmenu-0.8-1.3.35.patch.

	Eg: patch -p1 <../kmenu-0.8/kmenu-1.2.10.patch

    Look for failed junks and apply them by hand, it shouldn't too much.
    You can also use the -F option to patch and a fuzz factor of 5 or so,
    but the resulting file is not guaranteed to work correctly. For example
    you can do this by "cd arch/i386;patch -F5 config.in <config.in.rej".
    You should check the result against the .rej file to be sure of having
    correct results.

5.) type "make menuconfig" and check if it works.

If you want to use the kernel config help text from Axel Boldt do additionally:
(With these help texts the script provides you with full context sensitive
help.)

6.) If you use linux-1.3.37 or newer, skip this, you have already proper
    help texts for your kernel!

    Get the file krnl_cnfg_hlp_1.2.13.tgz for 1.2 and 1.1 series kernels or
    krnl_cnfg_hlp_1.3.28.tgz for 1.3 series kernels. The URLs are:

 ftp://sunsite.unc.edu/pub/Linux/system/kernel/config/krnl_cnfg_hlp_1.2.13.tgz
 ftp://sunsite.unc.edu/pub/Linux/system/kernel/config/krnl_cnfg_hlp_1.3.28.tgz

    If you have WWW access, the newest edit of the help texts is available via:

           http://math-www.uni-paderborn.de/~axel/config_help.html

7.) Follow the instructions in the included file README to install the help
    texts. If you want to use the help texts with the included Configure
    script, you can first install it and then apply my patch to it.
    Elsewhere, you 

8.) start "make menuconfig" and enter anything not possible for a value
    you want to change (eg. "?") and you'll get the help about this value.

                                That's all!

I'd accept help in improving and documenting kmenu and developing an
installation kit.

Please don't hesitate to send me any comments and especially I want to
hear from you if you have decided to use it regulary. You probably can
help me with such mails if you want this to be in the standard kernel.
If you do this I can offer you to get the newest versions automatically 
before I release them to the public.
                                           Bernhard Kaindl

Copyright (C) 1995 Bernhard Kaindl, GNU GENERAL PUBLIC LICENCE

If you have any problem installing or using menuconfig, send mail to
lupus@sbox.tu-graz.ac.at, he forwards my mail to me. If you have trouble,
you can also try to reach Axel Boldt, his address is <boldt@math.ucsb.edu>.
