=encoding UTF-8

=head1 NAME

specrb - standalone test runner for test/spec and Test::Unit test suites

=head1 SYNOPSIS

B<specrb> [I<OPTIONS>] [I<FILES> | -a ] [-- untouched arguments]

=head1 DESCRIPTION

The Ruby script B<specrb> allows you to run tests written with test/spec from
the command line. It can also be used for plain Test::Unit test suites. You can
either specify the names of the test files you want to run, or let B<specrb>
find automatically all the tests in your project, by using the B<-a> switch
(see TEST/SPEC OPTIONS below).

You can also use various options on the command line to pass parameters to the
Ruby interpreterm or to modify the behavior of test/spec and/or test/unit.

=head1 RUBY OPTIONS

=over

=item B<-e>, B<--eval> LINE

evaluate a LINE of code

=item  B<-d>, B<--debug>

set debugging flags (set $DEBUG to true)

=item B<-w>, B<--warn>

turn warnings on for your script

=item B<-I>, B<--include> PATH

specify $LOAD_PATH (may be used more than once)

=item B<-r>, B<--require> LIBRARY

require the LIBRARY, before executing your script

=back


=head1 TEST/SPEC OPTIONS:

=over

=item B<-s>, B<--specdox>

do AgileDox-like output

=item B<--rdox>

do AgileDox-like output with RDoc formatting

=item B<-a>, B<--automatic>

gather tests from ./test/, include ./lib/

=back


=head1 TEST::UNIT OPTIONS:

=over

=item B<-n>, B<--name> NAME

runs tests matching regexp NAME

=item B<-t>, B<--testcase> TESTCASE

runs tests in TestCases matching regexp TESTCASE

=back


=head1 COMMON OPTIONS:

=over

=item B<-h>, B<--help>

show a message similar to this manpage

=item B<--version>

show version

=back

=head1 AUTHORS

The test/spec library has been written by Christian Neukirchen <http://purl.org/net/chneukirchen>.

This manual page, inspired by the help message of B<specrb>, has been written
for the Debian Project by Cédric Boutillier (but may used by others).
