1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
'\" t
.\" aegis - project change supervisor
.\" Copyright (C) 1998, 1999 Peter Miller;
.\" All rights reserved.
.\"
.\" 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 2 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, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: manual page describing the aeclone command.
.\"
.so z_name.so
.TH "\*(n) -clone" 1 \*(N) "Reference Manual" ""
.SH NAME
\*(n) -clone \- make an exact copy of a change
.SH SYNOPSIS
.B \*(n)
.B \-CLone
[
.IR option \&...
]
.I change-number
[
change-number
]
.br
.B \*(n)
.B -CLone
.B -Help
.br
.B \*(n)
.B -CLone
.B -VERSion
.SH DESCRIPTION
The
.I "\*(n) -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.
.PP
One change number
.I 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).
.PP
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.
.PP
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
.I "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.
.SS Development Directory Location
.so z_filelocn.so
.so z_whiteout.so
.SH OPTIONS
The following options are understood:
.so o_branch.so
.so o_change.so
.so o_dir.so
.so o_help.so
.so o_list.so
.so o_whiteout.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 change number. Useful for writing scripts.
.so o_project.so
.so o_trunk.so
.so o_wait.so
.so o__rules.so
.SH 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
.IR aepattr (5)
for more information.)
.so z_exit.so
.br
.ne 1i
.SH SEE ALSO
.TP 8n
.IR aenc (1)
Create a new change.
.TP 8n
.IR aeca (1)
modify the attributes of a change
.TP 8n
.IR aena (1)
add a new administrator to a project
.TP 8n
.IR aepa (1)
modify the attributes of a project
.so z_cr.so
|
