You can modify many attributes of a task, such as the synopsis,
platform, priority, resolver, and much more. You must have task assignment
privileges and be able to modify the task.
About this task
ccm task -mod|-modify [-s|-synopsis synopsis]
[-desc|-description description]
[-desc_edit|-descriptionedit|-description_edit]
[-desc_file|-descriptionfile|-description_file file_path]
[-desc_replace|-descriptionreplace|-description_replace]
[-p|-priority priority] [-plat|-platform platform]
[-r|-resolver resolver] [-rel|-release release_spec]
[-sub|-subsystem subsystem] [-time|-time_estimate time_estimate]
[-date|-date_estimate date_estimate] task_spec...
- -date|-date_estimate date_estimate
- Specifies the estimated completion date of the tasks you are creating.
If you do not specify the date estimate, it is set to the date estimate
of the task you are copying. The date_estimate must
be a valid date.
- -desc|-description description
- Specifies a single-line description. The description cannot contain
newline characters.
- -desc_edit|-description_edit
- Specifies to start the default text editor so you can edit or
compose a multi-line description.
- -desc_file|-description_file file_path
- Specifies a path to a file containing a multi-line description.
- -desc_replace|-descriptionreplace|-description_replace
- Specifies to replace the existing task description with the specified
description. By default, the description is appended to the existing
task description. The description cannot contain newline characters.
- -date|-date_estimate date_estimate
- Specifies the estimated completion date of the tasks you are creating.
If you do not specify the date estimate, it is set to the date estimate
of the task you are copying. The date_estimate must
be a valid date.
- -def|-default|-current
- Specifies that the first task created from the task copy will become
the current task for this CLI session.
- -desc|-description description
- Specifies a single-line description. The description cannot contain
newline characters.
- -desc_edit|-description_edit
- Specifies to start the default text editor so you can edit or
compose a multi-line description.
- -desc_file|-description_file file_path
- Specifies a path to a file containing a multi-line description.
- -rel|-release release_spec
- Specifies the release for the created tasks. If you do not specify
a release, it is set to the release of the task you are copying. You
can set the release_spec to one release. For details,
see Release specification
- -r|-resolver resolver
- Specifies which user is responsible for resolving the tasks. If
not specified, it is set to the resolver of the task you're modifying.
The resolver must be a valid task resolver.
- -sub|-subsystem subsystem
- Specifies the task subsystem for the created tasks (for example,
Any, GUI code, CLI code, or documentation). If you do not specify
a subsystem, it is set to the subsystem of the task you are copying.
The subsystem must be a valid task subsystem.
- -s|-synopsis synopsis
- Specifies the synopsis of the task you're copying. The synopsis
can be any string without newline characters.
- task_spec...
- Specifies the tasks to be modified. You can set the task_spec to
multiple tasks. For more details, see Task specification.
- -time|-time_estimate time_estimate
- Specifies the estimated duration or effort to complete the created
tasks. If you don't specify a time estimate, it is set to the
time estimate of the task you're copying. The time_estimate can
be any string. However, to help with reporting and metrics, be sure
to adopt a consistent convention for format and units.