Difference Command

TFS 2017 | TFS 2015 | TFS 2013

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Compares, and if it is possible, displays differences between two files, files in two folders, or a shelveset and a local or a server file.

Prerequisites

To use the difference command, you must have the Read permission for all specified items set to Allow. For more information, see Default TFVC permissions.

Syntax

tf diff[erence] itemspec [/version:versionspec] [/type:filetype] 
[/format:format [/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] 
[/options][/noprompt][/login:username,[password]]

tf diff[erence] itemspec itemspec2 [/type:filetype] [/format: format] 
[/ignorespace] [/ignoreeol] [/ignorecase] [/recursive] [/options] [/noprompt][/login:username,[password]]

tf diff[erence] [/shelveset:shelvesetname[;shelvesetowner]] 
shelveset_itemspec [/type:filetype] 
[/format: format] [/ignorespace] [/ignoreeol] [/ignorecase] 
[/recursive] [/options] [/noprompt][/login:username,[password]]

tf diff[erence] /configure

Parameters

Argument

Option

Remarks

You can use the difference command to compare and if it is possible, display differences between:

• Two different files or two versions of the same file.

• One or more of the items in a folder.

• One, some, or all the items in a shelveset on the Team Foundation Server.

You can use the difference command to compare both versioned and non-versioned files.

Team Foundation categorizes all files by type. Text files can be merged and compared, side by side and line by line, as long as both files have the same encoding. If you want to compare two files whose encodings are not the same, you can temporarily mask, or override the encoding property for a file by using the /type option. Binary files can be compared but cannot be merged. When you pass one or more binary files to the difference command, Team Foundation indicates whether differences exist between it and the item to which it is being compared. For more information about how Team Foundation differentiates between and treats files of disparate types, see Managing File Types.

If you specify two file names, the two files are compared. Instead of using the /version flag, you can specify versions by appending a semicolon and version specifier to the end of each file name.

If you pass only one itemspec to the difference command:

• If do not provide a versionspec, your current workspace version of the item is compared to the base workspace version, by default. For example, tf difference header.h compares the current version of header.h to the version upon which header.h is based.

• If you include a versionspec in your itemspec such as , tf difference header.h;LBeta1, Team Foundation compares that version to your current workspace version on disk.

• If you specify a range of versions such as /version:C1~C4, the versions of the file at the two end points of the range are compared.

For more information on how to find the tf command-line utility, see Use Team Foundation version control commands.

Output Format types

The format parameter, used with the /format option, specifies many different output formats. The available output types are

• Visual

  Visual format type opens an external difference application. By default diffmerge.exe is launched.

• Brief

  Brief format prints whether the files being compared differ.

• Context

  Context format provides lines of context for the differences in the files. This format is derived from the UNIX based diff -c output format.

• RCS

  RCS format is similar to /format:unix, except context lines are not supplied.

  No special handing for a missing end of line marker at the end of the file is provided.

• SS

  SS is default difference output format for Visual SourceSafe. For more information, see "Diff (Command Line)" at the Microsoft Web site (https://go.microsoft.com/fwlink/?LinkId=99139).

• SS_SideBySide

  SS_SideBySide is the default side-by-side output format for Visual SourceSafe.

• SS_Unix

  SS_Unix is similar to the /format:unix output format, but /format:ss_unix includes context lines and /format:unix does not.

• Unified

  Unified format is derived from the UNIX based diff -u output format. /format:context repeats identical context lines between the difference strings although /format:unified does not.

  Unified format produces a new unified difference string (@@ ... @@) line only when the distance to the next difference string is larger than the number of context lines.

• Unix

  This output type is derived from the UNIX based diff command output format.

  The Unix output format is constructed in the following way:

  <metadataline>
  "< " line prefix for lines from the first file
  "---" line
  "> " line prefix for lines from the second file
  
  <metadataline> can be one of these possibilities:
  #a#,# -- add lines from line # in file1 into file2 at lines #->#
  #,#d# -- delete lines from line # -> # in file 1 from file2 at line #
  #,#c#,# -- change lines from line # -> # in file1 into the lines in file2 at line # -> #
  
  # signs separated by commas indicate a line range.
  # signs before the character indicate line numbers in the first file
  # signs after the character indicate line numbers in the second file
  
  /// No end of line marker at the end of the file:
  /// \ No newline at end of file
  

  Examples

  The following example displays the differences between the local version of 314.cs and the workspace version of 314.cs that is the version of the file that was checked out from the Team Foundation version control server.

  c:\projects>tf difference 314.cs

The following example displays all files that have been changed in the src folder. Does not display files that have been changed in subfolders of src.

c:\projects>tf difference src /format:visual

The following example displays the differences between changeset 3 and changeset 8 of 1254.cs.

c:\projects>tf difference /version:C3~C8 1254.cs

The following examples display the differences between the version of 314.cs that belong to the label "release" and the version that belongs to changeset 3200.

c:\projects>tf difference 314.cs;Lrelease 314.cs;C3200

-or-

c:\projects>tf difference 314.cs;Lrelease~C3200

The following example displays the difference between the versions of e271.cs that a user named Nadia shelved in shelveset PeerCodeReview8 and the base shelveset version that is the version upon which she based her changes. Also displays the types of changes pending against e271.cs when Nadia shelved.

c:\projects> tf difference /shelveset:PeerCodeReview8;Nadia e271.cs

The following example displays the differences between all files in the PeerCodeReview2 shelveset and the base shelveset version of those files.

c:\projects> tf difference /shelveset:PeerCodeReview2

Related articles

• Merge Command
• Checkin Command
• Shelvesets Command
• Managing File Types
• Comparing Folders and Files