X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=README;h=4c8ade7f95a41e1e710264e23d5776edeaa94ac4;hb=1aa23b165011cf979483755c7a052c09e1240c6e;hp=a02ff2c0032fa317916924ce809ada860c84b268;hpb=fcd6e82eeffe477904903caacc9c2404494764b3;p=kconfig-frontends

diff --git a/README b/README
index a02ff2c..4c8ade7 100644
--- a/README
+++ b/README
@@ -1,12 +1,41 @@
-This directory contains the kconfig frontends and parser.
+This package contains the kconfig frontends and parser.
 
-Kconfig is the configuration language used by the Linux kernel.
-This package is a simple copy of the frontends and the parser found
-in the Linux kernel source tree, with very minor changes to adapt
-them to being built out of the kernel build infrastructure.
+Kconfig is the configuration language used by the Linux kernel. This package
+is a simple copy of the frontends and the parser found in the Linux kernel
+source tree, with very minor changes to adapt them to being built out of
+the kernel build infrastructure.
 
-This package does *not* take any change to the parser or frontends.
-Such changes shall be directed directly to the appropriate mailing
-list, and they will eventually find their way is this package at
-the next sync:
+This package does *not* take any change to the parser or frontends. Such
+changes shall be directed directly to the appropriate mailing list, and they
+will eventually find their way is this package at the next sync:
     mailto:linux-kbuild@vger.kernel.org
+
+However, if there is a bug in the packaging infrastructure, patches are
+most welcome, of course! Most notably, because this is my very first
+autostuff-based package, I may have done mistakes here and there...
+
+As such, there are currently a few known limitations:
+
+- statically linking is much, much more complex than it should be. I have
+  been seemingly able to build part of the frontends with such incantations
+  of ./configure and make:
+    ./configure LDFLAGS=-static nconf_EXTRA_LIBS=-lgpm  \
+                --disable-shared --enable-static        \
+                --disable-gconf --disable-qconf
+    make LDFLAGS="-all-static -static-libtool-libs"
+
+- the nconf frontends requires (at least on my machine) to be linked against
+  GPM; this is not detected when statically linking (hence the nconf_EXTRA_LIBS
+  in the command above).
+
+- statically linking the graphical frontends (gconf and qconf) is *not*
+  supported: I am missing static libs for Qt3Support, so qconf does not link.
+  And there is a stupid bug in libtool that prevents properly linking against
+  installed static libraries (seemingly fixed in 2.4, but not quite yet, in
+  fact...), so gconf does not link. That's why they are disabled above.
+
+For a list of known issues, please also refer to file docs/known-issues.txt.
+
+Note that, provided you have the required dependencies, all frontends are
+properly built if you link dynamically. The following just works as expected:
+    ./configure && make