Showing candidates

Candidates are all the file versions that are eligible to be used in a directory entry. You can show candidates for an object or directory entry, and format the output in various ways.

About this task

ccm cand|candidates [-r|-recommend] [-f|-format format] [-nf|-noformat] 
                    ([-ch|-column_header] | [-nch|-nocolumn_header]) 
                    [-sep|-separator separator] ([-sby|-sortby sortspec] | 
                    [-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] 
                    [-u|-unnumbered] file_spec...
-ch|-column_header
Specifies to use a column header in the output format. See -ch|-column_headers for details.
file_spec
Specifies the name of the object or directory entry for which the candidate versions are listed. See File specification for details.
-f|-format format
Specifies to use a column header in the output format. See -f|-format for details.

A keyword can be built in (%fullname, %displayname, %objectname) or the name of any existing attribute such as %modify_time or %status.

See Built-in keywords for a list of keywords.

-gby|-groupby groupformat
Specifies how to group the command output. See -gby|-groupby for details.
-nch|-nocolumn_header
Specifies not to use a column header in the output format. See -nch|-nocolumn_header for details.
-nf|-noformat
Specifies not to use column alignment. See -nf|-noformat for details.
-ns|-nosort|-no_sort
Specifies not to sort the command output. See -ns|-nosort for details.
-r|-recommend
Results in the version being recommended. The recommended version is selected based on the selection rules. With the default format, the recommended version is marked with an asterisk (*). In a user-specified format, use the keyword %recommended to show the computed, recommended version.
-sby|-sortby sortspec
Specifies how to sort the command output. See -sby|-sortby for details.
-sep|-separator separator
Used only with the -f|-format option. Specifies a different separator character. See -sep|-separator for details.
-u|-unnumbered
Suppresses automatic numbering of the output (that is, the output is not numbered). See -u|-unnumbered for details.

Example

List the versions of Xincls.h that can be members of the current project in the directory, and recommend the version to use.
ccm cand Xincls.h -recommend
1) Xincls.h-1 integrate john  incl projX 1 5
2) Xincls.h-2 integrate john  incl projX 1 12
3) Xincls.h-3 integrate mary  incl projX 1 13
4) Xincls.h-4 integrate mary  incl projX 1 15 *

Feedback