[fU] added option: --help-X

[stephan b. <st...@ei...>]

Added test: toc_tests_help:

It looks for --help-X. If none are found it exits with zero.
If any are found it looks in the X test for a block like this:

# toc_begin_help =
# This test does something amazing!
# It shows how to use --help-X!!!
# = toc_end_help

If it finds such text it outputs it like so:

==1== test: [toc_tests_help] checks for --help-X and tries to do 
something about it.
help: gnu_cpp_tools
    It takes the following configure arguments:
    --enable-debug    causes stuff to be built -g instead of -02.  This 
is a
    little weird, but you can control the optimization level
    with --enable-debug="-O3 -fno-inline" etc.
    --enable-warn     causes stuff to be built -Wall.  To turn on 
-Werror, go
    --enable-warn="-Wall -Werror" etc.

    It calls toc_add_make for the following:
    - CC         /path/to/gcc?
    - INCLUDES   probably empty
    - CPPFLAGS   probably empty
    - OPT        -g or -O2 (or some other value specified by 
--enable-debug)
    - WARN       -Wall (or some other value specified by --enable-warn)
    - CFLAGS     probably empty (or maybe -pipe)
    - CXXFLAGS   probably empty (or maybe -pipe)
    - LDFLAGS    probably empty


If it finds any help vars it returns 1, the assumption being that you 
don't want to continue if the user used --help.

(FYI, the 1 in "==1==" is the current test nesting level.)

TODO: add support for --help-tests, which shows help for all tests.

-- 
----- stephan
st...@ei... - http://www.einsurance.de
"...control is a degree of inhibition, and a system which is perfectly
inhibited is completely frozen." -- Alan W. Watts