| 1 | = Trac Changeset Module = |
| 2 | Trac has a built-in functionality for visualizing diffs - changes to files. |
| 3 | |
| 4 | == The Changeset View == |
| 5 | |
| 6 | When viewing a commited changeset, such as when clicking a changeset |
| 7 | [wiki:TracLinks TracLink] or a changeset event-line in the |
| 8 | [wiki:TracTimeline timeline], Trac will display what changes this current set |
| 9 | of patches imposes. |
| 10 | |
| 11 | |
| 12 | The changeset view consists of two parts, the '''header''' and the '''diff view'''. |
| 13 | |
| 14 | === Changeset Header === |
| 15 | |
| 16 | The diff body shows an overview of the whole changeset. |
| 17 | Here you will find information such as: |
| 18 | |
| 19 | * Revision -- The unique revision ID for this changeset. |
| 20 | * Timestamp -- When the changeset was commited. |
| 21 | * Author -- Who commited the changeset. |
| 22 | * Message -- A brief description from the author (the commit log message). |
| 23 | * Files -- A list of files affected by this changeset. |
| 24 | |
| 25 | In front of each listed file, you'll find a colored rectangle. The color |
| 26 | indicates how the file is affected by the changeset. |
| 27 | |
| 28 | * Green: Added |
| 29 | * Red: Removed |
| 30 | * Orange: Modified |
| 31 | |
| 32 | The color legend is located below the header as a reminder. |
| 33 | |
| 34 | === Diff View === |
| 35 | Below the header is the main part of the changeset, the diff view. |
| 36 | |
| 37 | Each file is shown in a separate section, divided by a dashed line in the |
| 38 | center. This is a '''side-by-side''' view showing only the portions of the file |
| 39 | affected by this changeset. |
| 40 | |
| 41 | On the left hand side are the contents of the old version of the file, on the |
| 42 | right side the new. To visualize the difference between the old and new |
| 43 | version, each block of lines altered by the changeset has a colored |
| 44 | background. The color reflect the change, and the meaning the same as in the |
| 45 | header (see above). |
| 46 | |
| 47 | |
| 48 | See also: TracGuide, TracBrowser |