
                  Installation Guide  for kmenu-0.7


This file is a part of kmenu-0.7, 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.7/Configure.menu scripts

    If you have linux-1.3.36 or greater, copy the file Configure.menu.awk
    also to the scripts directory

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

4.) 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. And if your kernel is 1.3.35 or over you need only
    the small patch in kmenu-0.7-1.3.35.patch.

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

    If you have linux-1.3.36, apply the patch linux-1.3.36-cfg.fix to your
    kernel if you have not all these fixes for the bugs in the config of
    linux-1.3.36 already appied. In linux-1.3.37 these should have been
    fixed.

    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

    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 (bkaindl@ping.at) GNU GENERAL PUBLIC LICENCE
