 -New_Change(1)

NAME
-New_Change - add a new change to a project

SYNOPSIS
-New_Change [ number ] -File attr-file [ option... ]
-New_Change [ number ] -Edit [ option... ]
-New_Change -List [ option... ]
-New_Change -Help

DESCRIPTION
The -New_Change command is used to add a new change to a project. See aecattr(5) for information on the format of the attr-file.

The change is created in the awaiting development state. The change is not assigned to any user. The change has no development directory.

You may choose your own change number if you want, provided that it has not been used already. If you do not specify a change number, will allocate the lowest unused change number. The first few change numbers are reserved for branches later in the project, and so automatically allocated change numbers will usually not start from 1. See aepa(1) and aepattr(5) for more information.

You must give the -Project option, see below.

  Notification
This is one of the rare "state transitions" which does not have a notification command. The assumption is this command is invoked by the system which usually receives notifications.

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 change number. Useful for writing scripts.

-Project name
    This option is used to select the project for the new change.

    You must supply the -Project option to this command. Experience has shown that when a site has a number of active projects or several active branches on a project, new changes are frequently created against the wrong project or the wrong branch. Making the project explicit reduces this problem.

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

ERRORS
It is an error if the current user is not an administrator of the project. (In some cases it is possible for developers of a project to create changes, see aepattr(5) for more information.)

SEE ALSO

tkaenc(1)
    GUI interface to the aenc(1) command.

aeca(1)
    modify the attributes of a change

aedb(1)
    begin development of a change

aena(1)
    add a new administrator to a project

aencu(1)
    remove a new change from a project

aenpr(1)
    create a new project

aepa(1)
    modify the attributes of a project

aecattr(5)
    change attributes file format

aepattr(5)
    project attributes file format

aeuconf(5)
    user configuration file format