Running file differences reports

File differences reports include the differences between two or more versions of a text file. You can run these reports when viewing file history. See Viewing file history.

Tip: If you need to create patches for distributing source code updates, run a differences report and save the output as a text file. This text file contains the patch code. You can send the file to a customer to apply to their copy of the source file using GNU Project's Patch utility. See Tips for Making and Using Patches for information.

1. Select a file and choose Activities > History.

The History dialog box opens.

Tip: You can also view file differences in a History report. See Creating history reports.

2. Select the files to include in the report.

3. Click the Differences Report button.

The Generate File Differences Report dialog box opens.

4. Select a Version to Include option.

5. Select any additional report Options.

6. Select an Output Format.

When you view differences, you may also want to see the parts of the files near the lines that differ to help you understand what changed. This is the context.

If you are distributing new versions of files in the form of diff output, use one of the output formats that show context so users can easily apply the differences.

7. Click OK.

The report opens.

8. Click Save As to save the report or Print to print it.

9. Click OK when you finish.

Symbol meanings

The following symbols indicate differences in a differences report.

Symbol Meaning
! A line that is part of a group of lines that changed between the two versions (context format only)
+ Inserted line
- Deleted line