
                    Installation Guide  for kmenu-0.6


This file is a part of kmenu-0.6, see COPYING for licence information.

kmenu can be used with most kernels which are configured by 'Configure'
in conjunction with 'config.in' and '.config'.
This includes most linux-1.1.* kernels and all linux-1.[23].* kernels.

Installation:

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

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 file "Configure.menu" from this distribution into the
    "scripts"-directory.

    	Eg: cp ../kmenu-0.6/Configure.menu scripts

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

	Eg: patch -p1 <../kmenu-0.6/kmenu-0.6-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.

    Again: If you have problems with this guide, read the Kernel-HOWTO.

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

7.) Follow the instructions in the included file README to install the help
    texts. Don't install Configure; just put Configure.help in place.

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 (e-mail: bkaindl@ping.at)
Address of author: Tallak 95
                   8103 Rein - Austria

