| 1 | = Viewing Revision Logs = |
| 2 | [[TracGuideToc]] |
| 3 | |
| 4 | When you browse the repository, it's always possible to query the |
| 5 | ''Revision Log'' view corresponding to the path you're currently seeing. |
| 6 | This will display a list of the most recent changesets in which the |
| 7 | current path or any other path below it has been modified. |
| 8 | |
| 9 | == The Revision Log Form == |
| 10 | |
| 11 | It's possible to set the revision at which the revision log should |
| 12 | start, using the ''View log starting at'' field. An empty value |
| 13 | or a value of ''head'' is taken to be the newest changeset. |
| 14 | |
| 15 | It's also possible to specify the revision at which the log should |
| 16 | stop, using the ''back to'' field. By default, it's left empty, |
| 17 | which means the revision log will stop as soon as 100 revisions have |
| 18 | been listed. |
| 19 | |
| 20 | Also, there are three modes of operation of the revision log. |
| 21 | |
| 22 | By default, the revision log ''stops on copy'', which means that |
| 23 | whenever an ''Add'', ''Copy'' or ''Rename'' operation is detected, |
| 24 | no older revision will be shown. That's very convenient when working |
| 25 | with branches, as one only sees the history corresponding to what |
| 26 | has been done on the branch. |
| 27 | |
| 28 | It's also possible to indicate that one wants to see what happened |
| 29 | before a ''Copy'' or ''Rename'' change, by selecting the |
| 30 | ''Follow copies'' mode. This will cross all copies or renames changes. |
| 31 | Each time the name of the path changes, there will be an additional |
| 32 | indentation level. That way, the changes on the different paths |
| 33 | are easily grouped together visually. |
| 34 | |
| 35 | It's even possible to go past an ''Add'' change, in order to see |
| 36 | if there has been a ''Delete'' change on that path, before |
| 37 | that ''Add''. This mode corresponds to the mode called |
| 38 | ''Show only adds, moves and deletes''. |
| 39 | While quite useful at times, be aware that this operation is quite |
| 40 | resource intensive. |
| 41 | |
| 42 | Finally, there's also a checkbox ''Show full log messages'', |
| 43 | which controls whether the full content of the commit log message |
| 44 | should be displayed for each change, or only a shortened version of it. |
| 45 | |
| 46 | == The Revision Log Information == |
| 47 | |
| 48 | For each revision log entry, there are 7 columns shown: |
| 49 | 1. The first column contains a pair of radio buttons and should used |
| 50 | for selecting the ''old'' and the ''new'' revisions that will be |
| 51 | used for [wiki:TracRevisionLog#viewingtheactualchanges viewing the actual changes]. |
| 52 | 2. A color code (similar to the one used for the [wiki:TracChangeset#ChangesetHeader changesets]) |
| 53 | indicating kind of change. |
| 54 | Clicking on this column refreshes the revision log so that it restarts |
| 55 | with this change. |
| 56 | 3. The '''Date''' at which the change was made. |
| 57 | 4. The '''Revision''' number, displayed as `@xyz`. |
| 58 | This is a link to the TracBrowser, using that revision as the base line. |
| 59 | 5. The '''Changeset''' number, displayed as `[xyz]`. |
| 60 | This is a link to the TracChangeset view. |
| 61 | 6. The '''Author''' of the change. |
| 62 | 7. The '''Log Message''', which contains either a summary or the full commit |
| 63 | log message, depending on the value of the ''Show full log messages'' |
| 64 | checkbox in the form above. |
| 65 | |
| 66 | |
| 67 | == Inspecting Changes Between Revisions == |
| 68 | |
| 69 | The ''View changes...'' buttons (placed above and below the list |
| 70 | of changes, on the left side) will show the set of differences |
| 71 | corresponding to the aggregated changes starting from the ''old'' |
| 72 | revision (first radio-button) to the ''new'' revision (second |
| 73 | radio-button), in the TracChangeset view. |
| 74 | |
| 75 | Note that the ''old'' revision doesn't need to be actually |
| 76 | ''older'' than the ''new'' revision: it simply gives a base |
| 77 | for the diff. It's therefore entirely possible to easily |
| 78 | generate a ''reverse diff'', for reverting what has been done |
| 79 | in the given range of revisions. |
| 80 | |
| 81 | Finally, if the two revisions are identical, the corresponding |
| 82 | changeset will be shown (same effect as clicking on column 5). |
| 83 | |
| 84 | == Alternative Formats == |
| 85 | |
| 86 | === The ChangeLog Text === |
| 87 | |
| 88 | At the bottom of the page, there's a ''ChangeLog'' link |
| 89 | that will show the range of revisions as currently shown, |
| 90 | but as a simple text, matching the usual conventions for |
| 91 | !ChangeLog files. |
| 92 | |
| 93 | === RSS Support === |
| 94 | |
| 95 | The revision log also provides a RSS feed to monitor the changes. |
| 96 | To subscribe to a RSS feed for a file or directory, open its |
| 97 | revision log in the browser and click the orange 'XML' icon at the bottom |
| 98 | of the page. For more information on RSS support in Trac, see TracRss. |
| 99 | |
| 100 | ---- |
| 101 | See also: TracBrowser, TracChangeset, TracGuide |