This subcommand copies the contents of a folder to a new folder or an existing folder.
A developer or build manager can copy a folder to a new folder. When copying a folder to an existing folder, the destination folder must be modifiable by you.
About this task
ccm folder -cp|-copy folder_spec -new new_folder_name [-q|-quiet]
ccm folder -cp|-copy folder_spec -e|-existing folder_spec [-append]
[-q|-quiet]
- -append
- When used with -existing folder_spec option, specifies to append the tasks in the destination folder rather than replacing them with tasks from the source folder.
- -e|-existing folder_spec
- Specifies to copy the folder to an existing folder specified by folder_spec. The folder specification for the existing folder must identify one folder. See Folder specification for details.
- By default, the tasks in the source folder replace those in the destination folder. Use the -append option to append rather than replace tasks.
- folder_spec
- Specifies the folder to copy from. See Folder specification for details.
- -new new_folder_name
- Specifies to copy the folder to a new folder with the specified new_folder_name. The new_folder_name cannot contain newline characters.
- -q|-quiet
- Specifies to show the display name of the updated or created folder. The display name shows a valid Folder specification
Example
- Copy folder 95 to a new folder named Tasks Completed for Release 3.4 on September 15, 1997.
ccm folder -copy 95 -new "Tasks Completed for Release 3.4 on September 15, 1997"
Folder '95: Tasks Completed for Release 3.4' copied to '158: Tasks Completed for Release 3.4 on September 15, 1997'
- Copy folder 95 to an existing folder, number 103.
ccm folder -cp 95 -existing 103
Folder '95: Tasks Completed for Release 3.4' copied to '103: Tested Tasks for Release 3.4"
- Copy folder folder 95 to an existing folder 103, appending the tasks.
ccm folder -copy 95 -append -existing 103