 -New_ReLeaSe(1)

NAME
-New_ReLeaSe - create a new project from an old-style project.

SYNOPSIS
-New_ReLeaSe project-name [ new-project-name ][ option... ]
-New_ReLeaSe -List [ option... ]
-New_ReLeaSe -Help

DESCRIPTION
The -New_ReLeaSe command is used to create a new project from an existing project. It creates a new post-3.0 project from an old pre-3.0 project.

Please Note: If your old-style project does not have a version number in the project name, you must supply a new project name, otherwise you will get an error. (If you want to re-use the old project name, you need to rename the old project, and then use aenrls to create a new new-style project with the old name. See the HOWTO for how to change a project's name.)

This command was essential before the introduction of branches into the Aegis model. It is more useful to create a new release of a project by ending development on the branch of the previous release and starting development of a new branch numbered for the desired release.

Once you have a new-style project, use the aenbr(1) command to create new branches on this project. This provides more efficient release management, and allows historical versions to be reproduced more simply.

If no new-project-name is specified, it will be derived from the project given as follows: any minor version dot suffix will be removed from the name, then any major version dot suffix will be removed from the name. A major version dot suffix will be appended, and then a minor version dot suffix will be appended. As an example, "foo.1.0" would become "foo.1.1" assuming the default minor version increment, and "foo" would become "foo.1.1" assuming the same minor version increment.

The entire project baseline will be copied. The project state will be as if change 1 had already been integrated, naming every file (in the old project) as a new file. The history files will reflect this. No build will be necessary; it is assumed that the old baseline was built successfully. Change numbers will commence at 2, as will build numbers. Test numbers will commence where the old project left off (because all the earlier test numbers were used by the old project).

The default is for the minor version number to be incremented. If the major version number is incremented or set, the minor version number will be set to zero if it is not explicitly given.

The pointer to the new project will be added to the first element of the search path, or if none is set. If this is inappropriate, use the -LIBrary option to explicitly set the desired location. See the -LIBrary option for more information.

The project directory, under which the project baseline and history and state and change data are kept, will be created at this time. If the -DIRectory option is not given, the project directory will be created in the directory specified by the default_project_directory field of the project user's aeuconf(5), or if not set in project user's home directory; in either case with the same name as the project.

All staff will be copied from the old project to the new project without change, as will all of the project attributes.

  Project Directory Location

OPTIONS
The following options are understood:

-VERSion number
    This option may be used to specify the version number for the project. Version number are implemented as branches. Use the empty string as the argument if you want no version branches created.

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

ERRORS
It is an error if the old project named does not exist.

It is an error if the old project named has not yet had any changes integrated.

It is an error if the old project named has any changes not in the completed state.

It is an error if the current user is not an administrator of the old project.

SEE ALSO

aenpr(1)
    create a new project

aermpr(1)
    remove project

aeuconf(5)
    user configuration file format

Aegis User Guide
    The chapter on Branching has useful information about releases and branching.