CXXTESTGEN(1)							    User Manual 						     CXXTESTGEN(1)

NAME

       cxxtestgen - Generates test source files for CxxTest

SYNOPSIS

       cxxtestgen [options] [-o output] <file> ...

DESCRIPTION

       This  script parses the files provided and generates an output source file that can be build with traditional compiler to produce the test-
       runner executable.

OPTIONS

       -h
       --help Show help message and exit.

       --version
	      Write the CxxTest version.

       -o NAME
       --output=NAME
	      Write output to file NAME.

       -w WORLD
       --world=WORLD
	      The label of the tests, used to name the XML results.

       --include=HEADER
	      Include file HEADER in the test runner before other headers.

       --abort-on-fail
	      Abort tests on failed asserts (like xUnit).

       --main=MAIN
	      Specify an alternative name for the main() function.

       --headers=FILENAME
	      Specify a filename that contains a list of header files that are processed to generate a test runner.

       --runner=CLASS
	      Create a test runner that processes test events using the class CxxTest::CLASS.

	      The currently available runners are:

	      -  ErrorPrinter This is the standard error printer, which formats its output to the standard  output  stream  (std::cout).  Same	as
		 --error-printer.

	      -  ParenPrinter  Identical  to ErrorPrinter except that it prints line numbers in parantheses. This is the way Visual Studio expects
		 it.

	      -  StdioPrinter The same as ErrorPrinter except that it uses printf instead of std::cout.

	      -  XmlPrinter Print test results to an XML file.

	      -  XUnitPrinter This test listener generates output using both ErrorPrinter and XmlPrinter. Same as --xunit-printer.

       --gui=CLASS
	      Create a GUI test runner that processes test events using the class CxxTest::CLASS. (deprecated)

       --error-printer
	      Create a test runner using the ErrorPrinter class, and allow the use of the standard library.

       --xunit-printer
	      Create a test runner using the XUnitPrinter class.

       --xunit-file=XUNIT-FILE
	      The file to which the XML summary is written  for  test  runners	using  the  XUnitPrinter  class.   The	default  XML  filename	is
	      TEST-<WORLD>.xml, where <WORLD> is the value of the --world option.  (default: cxxtest)

       --have-std
	      Use the standard library (even if not found in tests).

       --no-std
	      Do not use standard library (even if found in tests).

       --have-eh
	      Use exception handling (even if not found in tests).

       --no-eh
	      Do not use exception handling (even if found in tests).

       --longlong=TYPE
	      Use  TYPE  as  for  long long integers. The default is for 'no' long long integer type to be specified, which is consistent with the
	      current C++ standard.

       --no-static-init
	      Do not rely on static initialization in the test runner.

       --template=TEMPLATE
	      Generate the test runner using file TEMPLATE to define a template.

       --root Write the main() function and global data for a test runner.

       --part Write the tester classes for a test runner.

       -f
       --fog-parser
	      Use new FOG C++ parser (Python 2.7 is required).

COPYRIGHT

       Copyright (C) 2008 Sandia Corporation

       This software is distributed under the LGPL License v2.1 Under the terms of Contract DE-AC04-94AL85000 with Sandia  Corporation,  the  U.S.
       Government retains certain rights in this software

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

CxxTest generator version 4					    2012-01-06							     CXXTESTGEN(1)