'\" t
.\" aegis - project change supervisor
.\" Copyright (C) 1991-1993, 1996-2000, 2002-2010, 2012 Peter Miller
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program. If not, see <http://www.gnu.org/licenses/>.
.\"
.so lib/en/man1/z_name.so
.TH "\*(n) \-New_Test" 1 \*(N) "Reference Manual"
.SH NAME
aegis new test \- add a new test to a change
.XX "aent(1)" "add a new test to a change"
.SH SYNOPSIS
.B \*(n)
.B \-New_Test
[
.IR option ...
][
.IR filename ...
]
.br
.B \*(n)
.B \-New_Test
.B \-List
[
.IR option ...
]
.br
.B \*(n)
.B \-New_Test
.B \-Help
.SH DESCRIPTION
The
.I \*(n)
.I \-New_Test
command is used to
add a new test to a change.
A new file is created in the development directory.
.PP
New tests default to \[lq]automatic\[rq] unless otherwise specified.
.so lib/en/man1/z_intuit.so
.SS Test Filename Generation
You may choose your own filename for a test,
by specifying it on the command line.
.PP
If no filename is specified on the command line,
a test filename is automatically generated.
This is controlled by the
.I new_test_filename
field of the project
configuration
file (see
.IR aepconf (5)
for more information.
All automatically generated test filenames within a project are
numbered uniquely.
The default pattern for new test filenames
is "\fItest/XX/tXXXX[am].sh\fP",
where
.I XX
is the first 2 digits of the test number,
.I XXXX
is the whole test number, and
.I [am]
is \f(CWa\fP for automatic tests
and \f(CWm\fP for manual tests.
.SS Modifying Tests
Tests may be modified in future by adding them to a change
with the
.IR aecp (1)
command.
Tests are treated just like any other source file,
and are subject to the same process.
.so lib/en/man1/z_template.so
.PP
Be careful to make sure that the test filename template pattern matches
the \fInew_test_filename\fP field.
.so lib/en/man1/z_filesize.so
.so lib/en/man1/z_retype.so
.SS Notification
The \fInew_test_command\fP in the project \fIconfig\fP file is run,
if set.  The \fIproject_\%file_\%command\fP is also run, if set, and
if there has been an integration recently.  See \fIaepconf\fP(5) for
more information.
.\" unlike the above, these next two start new sections
.so lib/en/man1/z_test_rtnl.so
.so lib/en/man1/z_test_corr.so
.SH OPTIONS
The following options are understood;
.so lib/en/man1/o_auto.so
.so lib/en/man1/o_baserel.so
.so lib/en/man1/o_change.so
.TP 8n
\fB\-Edit\fP
Edit the new test files one they have been created.
(This avoids the copy\[hy]and\[hy]paste step required to edit the new
test script when
it has an automatically generated file name.)
.so lib/en/man1/o_help.so
.so lib/en/man1/o_list.so
.so lib/en/man1/o_manual.so
.so lib/en/man1/o_nolog.so
.TP 8n
\fB\-Output\fP \fIfilename\fP
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.
.so lib/en/man1/o_project.so
.so lib/en/man1/o_template.so
.so lib/en/man1/o_terse.so
.so lib/en/man1/o_uuid.so
.so lib/en/man1/o_verbose.so
.so lib/en/man1/o_wait.so
.so lib/en/man1/o__rules.so
.SH RECOMMENDED ALIAS
The recommended alias for this command is
.nf
.ta 8n 16n
csh%    alias aent '\*(n) \-nt \e!* \-v'
sh$     aent(){\*(n) \-nt "$@" \-v}
.fi
.SH ERRORS
It is an error if
the change is not in the
.I "being developed"
state.
.br
It is an error if
the change is not assigned to the current user.
.so lib/en/man1/z_exit.so
.br
.ne 1i
.SH SEE ALSO
.TP 8n
.IR aecp (1)
copy an existing test into a change
.TP 8n
.IR aedb (1)
begin development of a change
.TP 8n
.IR aentu (1)
remove a new test from a change
.TP 8n
.IR aerm (1)
remove an existing test as part of a change
.TP 8n
.IR aet (1)
run tests
.TP 8n
.IR aeuconf (5)
user configuration file format
.so lib/en/man1/z_cr.so
.\" vim: set ts=8 sw=4 et :