summaryrefslogtreecommitdiffstats
path: root/Documentation/howto-build-sys.txt
diff options
context:
space:
mode:
authorKarel Zak2011-10-27 11:06:08 +0200
committerKarel Zak2011-11-03 12:32:49 +0100
commitaa594805265a1f2d0978e3e4bd2f1ec6a6c770f0 (patch)
tree28cf7206739ee7cc883165cbe16bc40d01c1b89e /Documentation/howto-build-sys.txt
parentbuild-sys: add UL_REQUIRES_* macros (diff)
downloadkernel-qcow2-util-linux-aa594805265a1f2d0978e3e4bd2f1ec6a6c770f0.tar.gz
kernel-qcow2-util-linux-aa594805265a1f2d0978e3e4bd2f1ec6a6c770f0.tar.xz
kernel-qcow2-util-linux-aa594805265a1f2d0978e3e4bd2f1ec6a6c770f0.zip
docs: add howto-build-sys.txt
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'Documentation/howto-build-sys.txt')
-rw-r--r--Documentation/howto-build-sys.txt30
1 files changed, 30 insertions, 0 deletions
diff --git a/Documentation/howto-build-sys.txt b/Documentation/howto-build-sys.txt
new file mode 100644
index 000000000..22ae8fc6f
--- /dev/null
+++ b/Documentation/howto-build-sys.txt
@@ -0,0 +1,30 @@
+util-linux build system
+=======================
+
+ - all util-linux specific autoconf macros use UL_ prefix
+
+ - utils in Makedile.am files are enabled/disabled according to BUILD_<NAME>
+ conditions (AM_CONDITIONAL), for example:
+
+ if BUILD_HWCLOCK
+ ...
+ endif
+
+ - all BUILD_<NAME> in configure.am are always based on build_<name> variables,
+ for example:
+
+ AM_CONDITIONAL([BUILD_HWCLOCK], test "x$build_hwclock" = xyes)
+
+ the $build_<name> should be available in whole configure script
+
+ - AC_ARG_ENABLE() status is always stored in $enable_<name> variable, possible
+ setting:
+
+ "check" - util/feature is optional, if any subcomponent (function, lib,
+ ...) is missing a warning is printed and the util/feature is
+ disabled
+
+ "yes" - util/feature is required, if any subcomponent (function, lib,
+ ...) is missing an error is printed and ./configure aborted
+
+ "no" - the util/feature is unwanted