- add central knob to turn off getopt_long everywhere. EXPERIMENTAL!
[oweals/busybox.git] / Config.in
index 33f6d9aee3d2d71190e9bed2da4cf8a2b521bc64..b299ee7301b4b462b132f1dd98407912f10d6738 100644 (file)
--- a/Config.in
+++ b/Config.in
@@ -37,15 +37,33 @@ config CONFIG_FEATURE_BUFFERS_GO_IN_BSS
 
 endchoice
 
+config CONFIG_SHOW_USAGE
+       bool "Show terse applet usage messages"
+       default y
+       help
+         All BusyBox applets will show help messages when invoked with
+         wrong arguments. You can turn off printing these terse usage
+         messages if you say no here.
+         This will save you up to 7k.
+
 config CONFIG_FEATURE_VERBOSE_USAGE
        bool "Show verbose applet usage messages"
        default n
+       select CONFIG_SHOW_USAGE
        help
          All BusyBox applets will show more verbose help messages when
          busybox is invoked with --help.  This will add a lot of text to the
          busybox binary.  In the default configuration, this will add about
          13k, but it can add much more depending on your configuration.
 
+config CONFIG_FEATURE_COMPRESS_USAGE
+       bool "Store applet usage messages in compressed form"
+       default y
+       depends on CONFIG_SHOW_USAGE
+       help
+         Store usage messages in compressed form, uncompress them on-the-fly
+         when <applet> --help is called.
+
 config CONFIG_FEATURE_INSTALLER
        bool "Support --install [-s] to install applet links at runtime"
        default n
@@ -62,11 +80,28 @@ config CONFIG_LOCALE_SUPPORT
          Enable this if your system has locale support and you would like
          busybox to support locale settings.
 
+config CONFIG_GETOPT_LONG
+       bool "Enable getopt long (system needs struct option for this to work)"
+       default n
+       depends on !CONFIG_NO_GETOPT_LONG
+       help
+         EXPERIMENTAL!
+         Enable this if your system support long options for getopt and
+         you want to use them in busybox.
+
+# remove this comment to disable getopt_long per default.
+#config CONFIG_NO_GETOPT_LONG
+#      bool
+#      default y
+#      depends on !CONFIG_GETOPT_LONG
+
 config CONFIG_FEATURE_DEVFS
-       bool "Support for devfs"
+       bool "Use devfs names for devices"
        default n
        help
-         Enable if you want BusyBox to work with devfs.
+         This tells busybox to look for names like /dev/loop/0 instead of
+          /dev/loop0.  If your /dev directory has normal names instead of
+          devfs names, you don't want this.
 
 config CONFIG_FEATURE_DEVPTS
        bool "Use the devpts filesystem for Unix98 PTYs"
@@ -139,14 +174,19 @@ config CONFIG_SELINUX
        bool "Support NSA Security Enhanced Linux"
        default n
        help
-         Enable support for SE Linux in applets ls, ps, and id.  Also provide
-         the option of compiling in SE Linux applets.
+         Enable support for SELinux in applets ls, ps, and id.  Also provide
+         the option of compiling in SELinux applets.
 
-         If you do not have a complete SE Linux Full Userland installed, this
-         stuff will not compile.  Go visit
+         If you do not have a complete SELinux userland installed, this stuff
+         will not compile. Go visit
                http://www.nsa.gov/selinux/index.html
-         to download the necessary stuff to allow busybox to compile with this
-         option enabled.
+         to download the necessary stuff to allow busybox to compile with
+         this option enabled. Specifially, libselinux 1.28 or better is
+         directly required by busybox. If the installation is located in a
+         non-standard directory, provide it by invoking make as follows:
+               CFLAGS=-I<libselinux-include-path> \
+               LDFLAGS=-L<libselinux-lib-path> \
+               make
 
          Most people will leave this set to 'N'.
 
@@ -265,17 +305,27 @@ endmenu
 menu 'Debugging Options'
 
 config CONFIG_DEBUG
-       bool "Build BusyBox with Debugging symbols"
+       bool "Build BusyBox with extra Debugging symbols"
        default n
        help
-         Say Y here if you wish to compile BusyBox with debugging symbols.
-         This will allow you to use a debugger to examine BusyBox internals
-         while applets are running.  This increases the size of the binary
-         considerably and should only be used when doing development.
-         If you are doing development and want to debug BusyBox, answer Y.
+         Say Y here if you wish to examine BusyBox internals while applets are
+         running.  This increases the size of the binary considerably, and
+         should only be used when doing development.  If you are doing
+         development and want to debug BusyBox, answer Y.
 
          Most people should answer N.
 
+config CONFIG_DEBUG_PESSIMIZE
+       bool "Disable compiler optimizations."
+       default n
+       depends on CONFIG_DEBUG
+       help
+         The compiler's optimization of source code can eliminate and reorder
+         code, resulting in an executable that's hard to understand when
+         stepping through it with a debugger.  This switches it off, resulting
+         in a much bigger executable that more closely matches the source
+         code.
+
 choice
        prompt "Additional debugging library"
        default CONFIG_NO_DEBUG_LIB
@@ -318,18 +368,11 @@ config CONFIG_EFENCE
 
 endchoice
 
-config CONFIG_STRIP_BINARIES
-       bool "Strip busybox objects"
-       default y if !CONFIG_DEBUG
-       default n if CONFIG_DEBUG
-       help
-         Whether or not we strip the busybox binary and such.
-
 config CONFIG_DEBUG_YANK_SUSv2
        bool "Disable obsolete features removed before SUSv3?"
        default y
        help
-         This option will disable backwards compatability with SuSv2,
+         This option will disable backwards compatibility with SuSv2,
          specifically, old-style numeric options ('command -1 <file>')
          will not be supported in head, tail, and fold.  (Note: should
          yank from renice too.)