 -clone(1)

NAME
-clone - make an exact copy of a change

SYNOPSIS
-CLone [ option... ] change-number [ change-number ]
-CLone -Help
-CLone -VERSion

DESCRIPTION
The -CLone command is used to create exact replicas of changes. This is of most use when a change need to be applied to several parallel branches.

One change number must be supplied. This is the change to be replicated. If any branch options are given (see below) the mandatory change number applies to the branch specified. If no branch is specified, the change applies to the project (implicit or explicit).

If the optional second change number is supplied, this is the change number to be created to hold the replica; if it is not supplied, the next available change number will be used.

If the change to be replicated has been completed, the appropriate file revisions will be extracted from history; otherwise the files will be copied from the development directory of the change to be copied. Be warned: if a file in the change which was cloned subsequently changes, those changes will not automagically be tracked. It is best if changes are cloned at a stable time, such as one of the states after develop end, or even after integrate pass.

  Development Directory Location

  Notification
The notification commands that would be run by the aecp(1), aedb(1), aenf(1), aent(1) and aerm(1) commands are run, as appropriate. The project_file_command is also run, if set. 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 change number. Useful for writing scripts.

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

aenc(1)
    Create a new change.

aeca(1)
    modify the attributes of a change

aena(1)
    add a new administrator to a project

aepa(1)
    modify the attributes of a project