Using Alternate Comparison and Merge Utilities

To use an alternate comparison or merge utility:

  1. Choose Tools > Personal Options.
  2. In the Personal Options dialog, select the File tab.
  3. To use an alternative merge utility, select the Merge Utility check box.
    1. Enter the path to or browse for the merge utility in the field.
    2. In the Options text box, add the appropriate command-line options for the utility. Use the following terms to identify the files the application will pass to the merge utility:
      $branchtip
      A place holder for the path to the tip revision of the file to be merged.
      $usertip
      A place holder for the path to the local working file to be merged.
      $basefile
      A place holder for the path to the common ancestor for the $branchtip and $usertip files.
      $resultfile
      A place holder for the path to the file that will store the output from the merged file.

    For example, suppose the Merge Utility field contains D:\Programs\Merge Utility 5\Mergeutil.exe and the Options text box contains -s $branchtip $usertip $basefile $resultfile. The application assumes that the options are appropriate for the utility to be used. Each time that it needs to call the merge utility, it replaces the terms that start with $ with the actual paths to those files and asks the operating system to execute the completed command.

  4. To use a comparison utility other than File Compare/Merge, select the Comparison Utility check box.
    1. Enter the path to or browse for the comparison utility in the field.
    2. In the Options field, add the appropriate command-line options for that utility. Use the following terms to identify the files that the application will pass to the comparison utility:
      $file1
      A place holder for the path to the first of the two files to be compared.
      $file2
      A place holder for the path to the second of the two files to be compared.

      For example, suppose the Comparison Utility field contains D:\Programs\Comparison Utility 8\Diffutil.exe and the Options field contains $file1 $file2. In this case, the application assumes that the options are appropriate for the utility to be used. Each time that the application needs to call the comparison utility, it replaces the terms that start with $ with the actual paths to those files and asks the operating system to execute the completed command.