annotate Config.in @ 1393:3e8ab37a4b60 draft

Find bugfixes. The check for -print vs -print0 was tested before I optimized out the "-" in the strcmps, and I didn't adjust the offset or retest it. (Ooops.) Also, I wasn't clearing the ! value when descending into parentheticals, so "find . -name blah -o \! \( -stuff -o -thing \)" acted like it had a spurious second ! before -stuff inside the parentheses.
author Rob Landley <rob@landley.net>
date Fri, 18 Jul 2014 18:31:41 -0500
parents 63d8181b0f92
children ed28d4d9558d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
1 mainmenu "ToyBox Configuration"
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
2
679
ed6ce9f11bf7 Put the commands at the start of menuconfig and the toybox library options at the end. (Aesthetic tweak.)
Rob Landley <rob@landley.net>
parents: 653
diff changeset
3
ed6ce9f11bf7 Put the commands at the start of menuconfig and the toybox library options at the end. (Aesthetic tweak.)
Rob Landley <rob@landley.net>
parents: 653
diff changeset
4 source generated/Config.probed
ed6ce9f11bf7 Put the commands at the start of menuconfig and the toybox library options at the end. (Aesthetic tweak.)
Rob Landley <rob@landley.net>
parents: 653
diff changeset
5 source generated/Config.in
ed6ce9f11bf7 Put the commands at the start of menuconfig and the toybox library options at the end. (Aesthetic tweak.)
Rob Landley <rob@landley.net>
parents: 653
diff changeset
6
ed6ce9f11bf7 Put the commands at the start of menuconfig and the toybox library options at the end. (Aesthetic tweak.)
Rob Landley <rob@landley.net>
parents: 653
diff changeset
7 comment ""
ed6ce9f11bf7 Put the commands at the start of menuconfig and the toybox library options at the end. (Aesthetic tweak.)
Rob Landley <rob@landley.net>
parents: 653
diff changeset
8
653
2986aa63a021 Move commands into "posix", "lsb", and "other" menus/directories.
Rob Landley <rob@landley.net>
parents: 496
diff changeset
9 menu "Toybox global settings"
10
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
10
233
d4176f3f3835 Zap toys/Config.in and instead create generated/Config.in from contents of
Rob Landley <rob@landley.net>
parents: 144
diff changeset
11 config TOYBOX
d4176f3f3835 Zap toys/Config.in and instead create generated/Config.in from contents of
Rob Landley <rob@landley.net>
parents: 144
diff changeset
12 bool
1032
40d0c96a8e89 Add scripts/single.sh to build individual non-multiplexed standalone commands.
Rob Landley <rob@landley.net>
parents: 956
diff changeset
13 default y
144
1fbc50374a30 Promote help to global config option, teach error_exit() to output usage message when called
Rob Landley <rob@landley.net>
parents: 90
diff changeset
14 help
1348
63d8181b0f92 Update toybox help to say how to install the static binary.
Rob Landley <rob@landley.net>
parents: 1032
diff changeset
15 usage: toybox [--long | [command] [arguments...]]
144
1fbc50374a30 Promote help to global config option, teach error_exit() to output usage message when called
Rob Landley <rob@landley.net>
parents: 90
diff changeset
16
857
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
17 With no arguments, shows available commands. First argument is
233
d4176f3f3835 Zap toys/Config.in and instead create generated/Config.in from contents of
Rob Landley <rob@landley.net>
parents: 144
diff changeset
18 name of a command to run, followed by any arguments to that command.
144
1fbc50374a30 Promote help to global config option, teach error_exit() to output usage message when called
Rob Landley <rob@landley.net>
parents: 90
diff changeset
19
1348
63d8181b0f92 Update toybox help to say how to install the static binary.
Rob Landley <rob@landley.net>
parents: 1032
diff changeset
20 --long Show path to each command
63d8181b0f92 Update toybox help to say how to install the static binary.
Rob Landley <rob@landley.net>
parents: 1032
diff changeset
21
63d8181b0f92 Update toybox help to say how to install the static binary.
Rob Landley <rob@landley.net>
parents: 1032
diff changeset
22 To install command symlinks, try:
63d8181b0f92 Update toybox help to say how to install the static binary.
Rob Landley <rob@landley.net>
parents: 1032
diff changeset
23 for i in $(/bin/toybox --long); do ln -s /bin/toybox $i; done
63d8181b0f92 Update toybox help to say how to install the static binary.
Rob Landley <rob@landley.net>
parents: 1032
diff changeset
24
370
c7a26e26ad08 Add TOYBOX_SUID.
Rob Landley <rob@landley.net>
parents: 233
diff changeset
25 config TOYBOX_SUID
c7a26e26ad08 Add TOYBOX_SUID.
Rob Landley <rob@landley.net>
parents: 233
diff changeset
26 bool "SUID support"
c7a26e26ad08 Add TOYBOX_SUID.
Rob Landley <rob@landley.net>
parents: 233
diff changeset
27 default y
c7a26e26ad08 Add TOYBOX_SUID.
Rob Landley <rob@landley.net>
parents: 233
diff changeset
28 help
857
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
29 Support for the Set User ID bit, to install toybox suid root and drop
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
30 permissions for commands which do not require root access. To use
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
31 this change ownership of the file to the root user and set the suid
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
32 bit in the file permissions:
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
33
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
34 chown root:root toybox; chmod +s toybox
370
c7a26e26ad08 Add TOYBOX_SUID.
Rob Landley <rob@landley.net>
parents: 233
diff changeset
35
417
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
36 config TOYBOX_FLOAT
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
37 bool "Floating point support"
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
38 default y
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
39 help
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
40 Include floating point support infrastructure and commands that
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
41 require it.
57e1335e59f6 Commit 415 needs the other two files. (Oops.)
Rob Landley <rob@landley.net>
parents: 370
diff changeset
42
858
34ac05521d94 Move guts of help command into show_help() in lib/help.c, with config TOYBOX_HELP controlling infrastructure.
Rob Landley <rob@landley.net>
parents: 857
diff changeset
43 config TOYBOX_HELP
926
6988ece404b2 Typo fix
Rob Landley <rob@landley.net>
parents: 858
diff changeset
44 bool "Help messages"
858
34ac05521d94 Move guts of help command into show_help() in lib/help.c, with config TOYBOX_HELP controlling infrastructure.
Rob Landley <rob@landley.net>
parents: 857
diff changeset
45 default y
34ac05521d94 Move guts of help command into show_help() in lib/help.c, with config TOYBOX_HELP controlling infrastructure.
Rob Landley <rob@landley.net>
parents: 857
diff changeset
46 help
34ac05521d94 Move guts of help command into show_help() in lib/help.c, with config TOYBOX_HELP controlling infrastructure.
Rob Landley <rob@landley.net>
parents: 857
diff changeset
47 Include help text for each command.
34ac05521d94 Move guts of help command into show_help() in lib/help.c, with config TOYBOX_HELP controlling infrastructure.
Rob Landley <rob@landley.net>
parents: 857
diff changeset
48
938
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
49 config TOYBOX_HELP_DASHDASH
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
50 bool "--help"
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
51 default y
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
52 depends on TOYBOX_HELP
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
53 help
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
54 Support --help argument in all commands, even ones with a NULL
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
55 optstring. Produces the same output as "help command".
812e8c5d026f Add config option for --help support in all commands.
Rob Landley <rob@landley.net>
parents: 926
diff changeset
56
710
cfdaead45479 Make internalization support optional
Felix Janda <felix.janda@posteo.de>
parents: 679
diff changeset
57 config TOYBOX_I18N
857
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
58 bool "Internationalization support"
710
cfdaead45479 Make internalization support optional
Felix Janda <felix.janda@posteo.de>
parents: 679
diff changeset
59 default y
cfdaead45479 Make internalization support optional
Felix Janda <felix.janda@posteo.de>
parents: 679
diff changeset
60 help
857
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
61 Support for UTF-8 character sets, and some locale support.
710
cfdaead45479 Make internalization support optional
Felix Janda <felix.janda@posteo.de>
parents: 679
diff changeset
62
90
7c77c6ec17ee Add "make defconfig". Modify global options to start with CONFIG_TOYBOX_.
Rob Landley <rob@landley.net>
parents: 25
diff changeset
63 config TOYBOX_FREE
10
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
64 bool "Free memory unnecessarily"
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
65 default n
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
66 help
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
67 When a program exits, the operating system will clean up after it
857
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
68 (free memory, close files, etc). To save size, toybox usually relies
da601285a86e Tweak help text.
Rob Landley <rob@landley.net>
parents: 710
diff changeset
69 on this behavior. If you're running toybox under a debugger or
10
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
70 without a real OS (ala newlib+libgloss), enable this to make toybox
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
71 clean up after itself.
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
72
90
7c77c6ec17ee Add "make defconfig". Modify global options to start with CONFIG_TOYBOX_.
Rob Landley <rob@landley.net>
parents: 25
diff changeset
73 config TOYBOX_DEBUG
25
eb46bb5626cb New option parsing infrastructure (doesn't use getopt). Hook it up to
Rob Landley <rob@landley.net>
parents: 17
diff changeset
74 bool "Debugging tests"
eb46bb5626cb New option parsing infrastructure (doesn't use getopt). Hook it up to
Rob Landley <rob@landley.net>
parents: 17
diff changeset
75 default n
eb46bb5626cb New option parsing infrastructure (doesn't use getopt). Hook it up to
Rob Landley <rob@landley.net>
parents: 17
diff changeset
76 help
eb46bb5626cb New option parsing infrastructure (doesn't use getopt). Hook it up to
Rob Landley <rob@landley.net>
parents: 17
diff changeset
77 Enable extra checks for debugging purposes.
eb46bb5626cb New option parsing infrastructure (doesn't use getopt). Hook it up to
Rob Landley <rob@landley.net>
parents: 17
diff changeset
78
10
4d21d59f3206 Add menuconfig, plus some basic Config info, lots of which is just future
landley@driftwood
parents:
diff changeset
79 endmenu