diff options
author | Rob Landley <rob@landley.net> | 2012-01-29 13:54:13 -0600 |
---|---|---|
committer | Rob Landley <rob@landley.net> | 2012-01-29 13:54:13 -0600 |
commit | b6063de0382e9145df7fdb63383244f68d355243 (patch) | |
tree | 1c22ab13bd376024dcd3bd5b9db60c3e95ec7037 /www | |
parent | 17876a03202fc43cda8f4146a8b3a3f8a6828b8b (diff) | |
download | toybox-b6063de0382e9145df7fdb63383244f68d355243.tar.gz |
Add <>= to lib/args.c, with documentation.
Diffstat (limited to 'www')
-rw-r--r-- | www/code.html | 32 |
1 files changed, 30 insertions, 2 deletions
diff --git a/www/code.html b/www/code.html index 541b1019..6eacb40d 100644 --- a/www/code.html +++ b/www/code.html @@ -356,7 +356,7 @@ code at compile time via the optimizer's dead code elimination (which removes from the binary any code that cannot be reached). This saves space without cluttering the code with #ifdefs or leading to configuration dependent build breaks. (See the 1992 Usenix paper -<a href=http://www.chris-lott.org/resources/cstyle/ifdefs.pdf>#ifdef +<a href=http://doc.cat-v.org/henry_spencer/ifdef_considered_harmful.pdf>#ifdef Considered Harmful</a> for more information.)</p> <p>USE_SYMBOL(code) evaluates to the code in parentheses when the symbol @@ -547,8 +547,20 @@ argument letter, indicating the option takes an additional argument:</p> <ul> <li><b>:</b> - plus a string argument, keep most recent if more than one.</li> <li><b>*</b> - plus a string argument, appended to a linked list.</li> -<li><b>#</b> - plus a singed long argument. A {LOW,HIGH} range can also be appended to restrict allowed values of argument.</li> <li><b>@</b> - plus an occurrence counter (stored in a long)</li> +<li><b>#</b> - plus a signed long argument. +<li><b>.</b> - plus a floating point argument (if CFG_TOYBOX_FLOAT).</li> +<ul>The following can be appended to a float or double: +<li><b><123</b> - error if argument is less than this</li> +<li><b>>123</b> - error if argument is greater than this</li> +<li><b>=123</b> - default value if argument not supplied</li> +</ul> +<ul><li>Option parsing only understands <>= after . when CFG_TOYBOX_FLOAT +is enabled. (Otherwise the code to determine where floating point constants +end drops out. When disabled, it can reserve a global data slot for the +argument so offsets won't change, but will never fill it out.). You can handle +this by using the USE_BLAH() macros with C string concatenation, ala: +"abc." USE_TOYBOX_FLOAT("<1.23>4.56=7.89") "def"</li></ul> </ul> <p>Arguments may occur with or without a space (I.E. "-a 42" or "-a42"). @@ -614,6 +626,22 @@ optflag, but letters are never control characters.)</p> <li><b>[yz]</b> this option requires at least one of y or z to also be enabled.</li> </ul> +<p>The following may be appended to a float or double:</p> + +<ul> +<li><b><123</b> - error if argument is less than this</li> +<li><b>>123</b> - error if argument is greater than this</li> +<li><b>=123</b> - default value if argument not supplied</li> +</ul> + +<p>Option parsing only understands <>= after . when CFG_TOYBOX_FLOAT +is enabled. (Otherwise the code to determine where floating point constants +end drops out. When disabled, it can reserve a global data slot for the +argument so offsets won't change, but will never fill it out.). You can handle +this by using the USE_BLAH() macros with C string concatenation, ala:</p> + +<blockquote>"abc." USE_TOYBOX_FLOAT("<1.23>4.56=7.89") "def"</blockquote> + <p><b>--longopts</b></p> <p>The optflags string can contain long options, which are enclosed in |