| | 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 |
|---|
