 -New_Test(1)

NAME
-New_Test - add a new test to a change

SYNOPSIS
-New_Test [ option... ][ filename... ]
-New_Test -List [ option... ]
-New_Test -Help

DESCRIPTION
The -New_Test command is used to add a new test to a change. A new file is created in the development directory.

New tests default to “automatic” unless otherwise specified.

  Test Filename Generation
You may choose your own filename for a test, by specifying it on the command line.

If no filename is specified on the command line, a test filename is automatically generated. This is controlled by the new_test_filename field of the project configuration file (see aepconf(5) for more information. All automatically generated test filenames within a project are numbered uniquely. The default pattern for new test filenames is "test/XX/tXXXX[am].sh", where XX is the first 2 digits of the test number, XXXX is the whole test number, and [am] is a for automatic tests and m for manual tests.

  Modifying Tests
Tests may be modified in future by adding them to a change with the aecp(1) command. Tests are treated just like any other source file, and are subject to the same process.

Be careful to make sure that the test filename template pattern matches the new_test_filename field.

  Notification
The new_test_command in the project config file is run, if set. The project_file_command is also run, if set, and if there has been an integration recently. See aepconf(5) for more information.

OPTIONS
The following options are understood;

-Output filename
    This option may be used to specify a filename which is to be written with the automatically determined test file name. Useful for writing scripts.

RECOMMENDED ALIAS
The recommended alias for this command is
csh%	alias aent ' -nt \!* -v'
sh$	aent(){ -nt "$@" -v}

ERRORS
It is an error if the change is not in the being developed state.
It is an error if the change is not assigned to the current user.

SEE ALSO

aecp(1)
    copy an existing test into a change

aedb(1)
    begin development of a change

aentu(1)
    remove a new test from a change

aerm(1)
    remove an existing test as part of a change

aet(1)
    run tests

aeuconf(5)
    user configuration file format