LOG
Description
Gets info about revisions in changesets.
Usage
cm log [<csetspec> | <repspec>] [--from=<csetspec_from>] [--allbranches] [--ancestors] [--csformat=<str_format>] [--itemformat=<str_format>] [--dateformat=<str_date_format>] [--xml[=<output_file>]] [--encoding=<name>] [--repositorypaths | --fullpaths | --fp]
Options
| Option / Argument | Description |
|---|---|
| --from | Lists all the changes made in every changeset from the changeset specification [csetspec_from] to the changeset specification [csetspec]. The [csetspec_from] changeset is not included in the output. Ignored when a repository spec is provided. |
| --allbranches | Shows information about the changesets created in a specified interval, for all the branches where those changesets were created. |
| --ancestors | Shows information about the reachable changesets by following the parent and merge links for the given changeset ([csetspec]). If the from changeset ([csetspec_from]) is provided too, it will be used as lower limit for all the paths. Remarks: The changeset changes will not be shown when this option is used. |
| --csformat | Retrieves the changeset info in a specific format. See Remarks for more info. This option cannot be combined with '--xml'. |
| --itemformat | Retrieves the item info in a specific format. See Remarks for more info. This option cannot be combined with '--xml'. |
| --dateformat | Sets the output format to print dates. |
| --xml | Prints the output in XML format to the standard output. It is possible to specify an output file. This option cannot be combined with '--csformat' and '--itemformat'. |
| --encoding | Used with the '--xml' option, specifies the encoding to use in the XML output, i.e.: utf-8. See the MSDN documentation at http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx to get the table of supported encodings and its format, (at the end of the page, in the "Name" column). |
| --fullpaths, --fp | Force printing full workspace paths for files and directories when possible. |
| --repositorypaths | Prints repository paths (server paths) instead of workspace paths. (This option overrides the '--fullpaths' option). |
| csetspec | Returns all changes made in the specified changeset. (Use 'cm help objectspec' to learn more about changeset specs.) |
| repspec | Returns all changes made in the specified repository. (Use 'cm help objectspec' to learn more about repository specs.) |
Help
Remarks
- If neither 'csetspec' nor option is specified, the command shows information about every changeset created within the last month in every branch.
- If only the option '--from' is included, the command shows the information about every changeset from that specified changeset to the last changeset in the branch where the changeset was created.
- If the option '--allbranches' appears without an interval, the command retrieves the same information as it would do if only 'csetspec' was specified.
- If the '--from' is used, the output contains information from the 'csetspec_from'+1 on.
- The repository used to show the changeset information is the one loaded in the path where the command executes on.
This command accepts a format string for the items ('--itemformat') and a format string for the changesets ('--csformat').
The output parameters of '--csformat' are the following
| Option / Argument | Description |
|---|---|
| {tab} | Inserts a tab space. |
| {newline} | Inserts a new line. |
| {changesetid} | Changeset number. |
| {branch} | Branch where the changeset was created. |
| {date} | Date of the changeset. |
| {owner} | Owner of the changeset. |
| {comment} | Comment of the changeset. |
| {items} | Items involved in the changeset. |
| {repository} | Repository where the changeset exists. |
| {repserver} | Server name. |
The output parameters of '--itemformat' are the following
| Option / Argument | Description |
|---|---|
| {tab} | Inserts a tab space. |
| {newline} | Inserts a new line. |
| {path} | Item path. |
| {branch} | Branch where the changeset was created. |
| {date} | Date of the changeset. |
| {owner} | Owner of the changeset. |
| {shortstatus} | Prints the short format for the status. See below. |
| {fullstatus} | Prints the long format for the status. See below. |
Short format and its corresponding long format
| Option / Argument | Description |
|---|---|
| 'A' | Added |
| 'D' | Deleted |
| 'M' | Moved |
| 'C' | Changed |
These are valid output strings
- --csformat="{newline}Changeset {changesetid} created on {date};{tab} changed items: {items}."
- --itemformat="{newline}The item {path} was changed in the branch {branch}."
Date format parameters (--dateformat)
To specify the output format in which dates will be printed. See the supported formats specified at:
https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
Examples
cm log
(Shows information about every changeset created in the last month in every branch.)
cm log cs:16
(Shows information about the changes done in the changeset 16 in the branch where the changeset was created.)
cm log cs:16 --csformat="{newline}Changeset {changesetid} created on {date};{tab} changed items: {items}."
(Shows the information in the specified format.)
cm log --from=cs:20 cs:50
(Shows the information about every revision contained in every changeset from the changeset 21 to the changeset 50.)
cm log --from=cs:20 cs:50 --allbranches
(Shows the information about every revision contained in every changeset from the changeset 21 to the changeset 50 in every branch of the repository.)
cm log rep:myrep@localhost:8084
(Shows information about the changes done in the specified repository. No workspace is required to run the command.)
cm log --from=cs:20@rep:mainRep@localhost:8084
(Shows the information about every revision contained in every changeset from the changeset 21. No workspace is required to run the command, because the full changeset spec was specified.)