NAME

       openscad-testrun - set up and run the OpenSCAD test suite

SYNOPSIS

       openscad-testrun [options]

DESCRIPTION

       This manual page documents briefly the openscad-testrun command.

       openscad-testrun  is  a  script  that sets up a directory in which the OpenSCAD test suite
       (implemented in ctest) can be run by creating symlinks to  the  system  locations  of  the
       input  data,  and runs it. The created directory is not removed, but will contain the test
       results in addition to the symlinks.

       It is required as the test suite in its original form  expects  all  the  test  input  and
       output  data  in relative locations, and the typical user has no write access to where the
       data resides. Future changes to the test suite might make it more flexible,  removing  the
       need for this script.

OPTIONS

       -d directory, --directory directory
              Set  up  the  tests  in a directory called directory. By default, this is generated
              from the current date and time like openscad-test-2012-02-15_13_37.

       -j N, --parallel N
              Run N test jobs in parallel. This can  also  be  set  in  the  CTEST_PARALLEL_LEVEL
              environment variable. The default is to run as many jobs as the number of available
              processing units available, as returned by nproc(1).

       -n, --dry-run
              Do not run the test suite, just set it up.

       --virtual
              Use xvfb-run to execute the tests inside a virtual X server.

       All additional arguments are passed on to ctest.

AUTHOR

       The OpenSCAD test suite was written by Clifford  Wolf,  Marius  Kintel,  and  others.  The
       openscad-testrun script was written by chrysn.

       This  manual page was written by chrysn <chrysn@fsfe.org>, for the Debian project (and may
       be used by others).

                                            2012-02-16                        OPENSCAD-TESTRUN(1)