Find revisions#

Find and filter revisions.

Filtering options#

The following list displays the different filtering options (where) that are available to use with the cm find revisions command:

• archived
• attribute
• attrvalue
• branch
• changeset
• date
• guid
• id
• item
• itemid
• label
• marker
• owner
• parent
• repllogid
• replsrcdate
• replsrcid
• replsrcrepository
• replsrcserver
• returnparent
• shelve
• size
• type
• workspacecheckoutid

Output options#

The following list displays the different output options (--format) available to use with the cm find revisions command:

• branch
• changeset
• date
• id
• item
• itemid
• owner
• parent
• size
• type

cm find revisions examples#

Find revisions made in a specific changeset#

You can use a custom format, for example if you only want to find the file and folder paths of the revisions in a specific changeset:

cm find revisions "where changeset=16716" --format="{path}"
d:\linked_replicated\
d:\linked_replicated\01nerva
d:\linked_replicated\01nerva\src
d:\linked_replicated\01nerva\src\client
d:\linked_replicated\01nerva\src\client\plastic
d:\linked_replicated\01nerva\src\client\plastic\libplasticTranslations.es.resx
d:\linked_replicated\01nerva\src\client\plastic\libplasticTranslations.resx
d:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.cs

Total: 8

You can also use PowerShell or Bash to filter by folder:

• Powershell:

  cm find revisions "where changeset=16716" --format="{path}" --nototal | where {$_ -match "client\\"}

• Bash:

  bcm find revisions "where changeset=15430" --format="{path}" --nototal | grep client\/

Find revisions for a branch#

The following example returns all the revisions for a specific changeset within a specified timespan:

cm find revisions "where branch = 'main/Fix-4.1/scm12814' and date <= '2013/05/30' and date > '2013/05/28'" --format="{date} - {path}"

You can also use PowerShell or Bash to filter the information:

• Powershell:

  cm find revisions "where branch = 'main/Fix-4.1/scm12814' and date <= '2013/05/30' and date > '2013/05/28'" --format="{date} - {path}" | where {$_ -match "view\\"}

• Bash:

  cm find revisions "where branch = 'main/Fix-4.1/scm12814' and date <= '2013/05/30' and date > '2013/05/28'" --format="{date} - {path}" | grep view\/`