Changes between Version 1 and Version 2 of TracRevisionLog


Ignore:
Timestamp:
09/01/12 10:21:30 (18 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracRevisionLog

    v1 v2  
    22[[TracGuideToc]] 
    33 
    4 When you browse the repository, it's always possible to query the 
     4When you browse the repository, it's always possible to query the  
    55''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 
     6This will display a list of the most recent changesets in which the  
    77current path or any other path below it has been modified. 
    88 
     
    1111It's possible to set the revision at which the revision log should 
    1212start, using the ''View log starting at'' field. An empty value 
    13 or a value of ''head'' is taken to be the newest changeset. 
     13or a value of ''head'' is taken to be the newest changeset.  
    1414 
    1515It'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 
     16stop, using the ''back to'' field. By default, it's left empty,  
     17which means the revision log will stop as soon as 100 revisions have  
    1818been listed. 
    1919 
    2020Also, there are three modes of operation of the revision log. 
    2121 
    22 By default, the revision log ''stops on copy'', which means that 
    23 whenever an ''Add'', ''Copy'' or ''Rename'' operation is detected, 
     22By default, the revision log ''stops on copy'', which means that  
     23whenever an ''Add'', ''Copy'' or ''Rename'' operation is detected,  
    2424no older revision will be shown. That's very convenient when working 
    2525with branches, as one only sees the history corresponding to what 
     
    2727 
    2828It's also possible to indicate that one wants to see what happened 
    29 before a ''Copy'' or ''Rename'' change, by selecting the 
     29before a ''Copy'' or ''Rename'' change, by selecting the  
    3030''Follow copies'' mode. This will cross all copies or renames changes. 
    3131Each time the name of the path changes, there will be an additional 
     
    3333are easily grouped together visually. 
    3434 
    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 
     35It's even possible to go past an ''Add'' change, in order to see  
     36if there has been a ''Delete'' change on that path, before  
     37that ''Add''. This mode corresponds to the mode called  
     38''Show only adds, moves and deletes''.  
     39While quite useful at times, be aware that this operation is quite  
    4040resource intensive. 
    4141 
     
    4646== The Revision Log Information == 
    4747 
    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 
     48For each revision log entry, there are 7 columns: 
     49 1. The first column contains a pair of radio buttons and should be used  
     50    for selecting the ''old'' and the ''new'' revisions that will be  
    5151    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. 
     52 1. A color code (similar to the one used for the 
     53    [wiki:TracChangeset#ChangesetHeader changesets]) indicating kind of change. 
    5454    Clicking on this column refreshes the revision log so that it restarts 
    5555    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'' 
     56 1. The '''Revision''' number, displayed as `@xyz`. 
     57    This is a link to the TracBrowser, using the displayed revision as the base line. 
     58 Next to it, you can see a little "wheel" icon [[Image(htdocs:../common/changeset.png)]],  which is clickable and leads to the TracChangeset view for that revision. 
     59 1. The '''Date''' at which the change was made. 
     60    The date is displayed as the time elapsed from the date of the revision. The time 
     61    elapsed is displayed as the number of hours, days, weeks, months, or years. 
     62 1. The '''Author''' of the change. 
     63 1. The '''Log Message''', which contains either the truncated or full commit  
     64    log message, depending on the value of the ''Show full log messages''  
    6465    checkbox in the form above. 
    65  
     66     
    6667 
    6768== Inspecting Changes Between Revisions == 
     
    7374radio-button), in the TracChangeset view. 
    7475 
    75 Note that the ''old'' revision doesn't need to be actually 
     76Note that the ''old'' revision doesn't need to be actually  
    7677''older'' than the ''new'' revision: it simply gives a base 
    77 for the diff. It's therefore entirely possible to easily 
     78for the diff. It's therefore entirely possible to easily  
    7879generate a ''reverse diff'', for reverting what has been done 
    7980in the given range of revisions. 
    8081 
    8182Finally, if the two revisions are identical, the corresponding 
    82 changeset will be shown (same effect as clicking on column 5). 
     83changeset will be shown (same effect as clicking on the !ChangeSet number). 
    8384 
    8485== Alternative Formats == 
    8586 
    86 === The ChangeLog Text === 
     87=== The !ChangeLog Text === 
    8788 
    88 At the bottom of the page, there's a ''ChangeLog'' link 
     89At the bottom of the page, there's a ''!ChangeLog'' link 
    8990that will show the range of revisions as currently shown, 
    9091but as a simple text, matching the usual conventions for