TracRevisionLog – The Trac Project

<!DOCTYPE html> <html lang="en-US"> <head>   <title> TracRevisionLog – The Trac Project </title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" />  <link rel="search" href="/search" /> <link rel="help" href="/wiki/TracGuide" /> <link rel="alternate" href="/wiki/TracRevisionLog?format=txt" title="Plain Text" type="text/x-trac-wiki" /> <link rel="start" href="/wiki" /> <link rel="stylesheet" href="/chrome/common/css/trac.css" type="text/css" /> <link rel="stylesheet" href="/chrome/common/css/wiki.css" type="text/css" /> <link rel="stylesheet" href="/chrome/wikiextras/css/phrases.css" type="text/css" /> <link rel="stylesheet" href="/chrome/wikiextras/css/boxes.css" type="text/css" /> <link rel="stylesheet" href="/wikiextras/dynamicboxes.css" type="text/css" /> <link rel="stylesheet" href="/chrome/vote/css/tracvote.css" type="text/css" /> <link rel="icon" href="/favicon.ico" type="image/x-icon" /> <noscript> <style> .trac-noscript { display: none !important } </style> </noscript> <link type="application/opensearchdescription+xml" rel="search" href="/search/opensearch" title="Search The Trac Project"/> <script src="/chrome/common/js/jquery.js"></script> <script src="/chrome/common/js/babel.js"></script> <script src="/chrome/common/js/trac.js"></script> <script src="/chrome/common/js/search.js"></script> <script src="/chrome/common/js/folding.js"></script> <script src="/chrome/common/js/wiki.js"></script> <script> jQuery(function($) { $(".trac-autofocus").focus(); $(".trac-target-new").attr("target", "_blank"); if ($.ui) { /* is jquery-ui added? */ $(".trac-datepicker:not([readonly])") .prop("autocomplete", "off").datepicker(); // Input current date when today is pressed. var _goToToday = $.datepicker._gotoToday; $.datepicker._gotoToday = function(id) { _goToToday.call(this, id); this._selectDate(id) }; $(".trac-datetimepicker:not([readonly])") .prop("autocomplete", "off").datetimepicker(); $("#main").addClass("trac-nodatetimehint"); } $(".trac-disable").disableSubmit(".trac-disable-determinant"); setTimeout(function() { $(".trac-scroll").scrollToTop() }, 1); $(".trac-disable-on-submit").disableOnSubmit(); }); </script>  <link rel="stylesheet" type="text/css" href="//www.edgewall.org/css/projects013.css" /> <script type="text/javascript"></script> <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/1.0.9/cookieconsent.min.js"></script> <script type="text/javascript"> jQuery(function($) { var $ntg = $("#newticketguide"); if ($ntg.length) $("#propertyform").prepend($ntg.detach()); }); </script>   <meta name="ROBOTS" content="NOINDEX, NOFOLLOW" /> <link rel="alternate" type="application/x-wiki" href="/wiki/TracRevisionLog?action=edit&version=" title="Edit this page"/> <script> jQuery(function($) { wikiColumn($("#wikipage")); }); </script>  </head> <body>    <div id="wrapper"> <div id="topbar"> <a id="home-link" href="//www.edgewall.org/">Edgewall Software</a> </div> <div id="ew-header"> <div id="topnav"><ul> <li><a href="//www.edgewall.org/">Home</a></li> <li class="active"> <a class="trac" href="//trac.edgewall.org/">Trac</a> </li> <li> <a href="//trac-hacks.org/">Trac Hacks</a> </li> <li class=""> <a class="genshi" href="//genshi.edgewall.org/">Genshi</a> </li> <li class=""> <a class="babel" href="//babel.edgewall.org/">Babel</a> </li> <li class=""> <a class="bitten" href="//bitten.edgewall.org/">Bitten</a> </li></ul> </div> </div> <div id="ew-main"> <div id="ew-content"> <div> <script src="//www.google-analytics.com/urchin.js" type="text/javascript"></script> <script type="text/javascript">_uacct = "UA-598265-1";urchinTracker();</script> <div id="left"> <div class="block"> <ul> <li><a href="/">Home</a></li> <li><a href="/wiki/TracDownload">Download</a></li> <li><a href="/wiki/TracGuide">Documentation</a></li> <li><a href="/wiki/MailingList">Mailing Lists</a></li> <li><a href="/wiki/TracLicense">License</a></li> <li><a href="/wiki/TracFaq">FAQ</a></li> </ul> </div> </div> </div>  <div id="banner"> <div id="header"> <a id="logo" href="//trac.edgewall.org/"> <img alt="Trac" height="73" src="//www.edgewall.org/gfx/trac_logo.png" width="236" /></a> </div> <form id="search" action="/search" method="get"> <div> <label for="proj-search">Search:</label> <input type="text" id="proj-search" name="q" size="18" value="" /> <input type="submit" value="Search" /> </div> </form> <div id="metanav" class="nav"> <ul><li class="first"><a href="/login">Login</a></li><li ><a href="/prefs">Preferences</a></li><li ><a href="/wiki/TracGuide">Help/Guide</a></li><li class="last"><a href="/about">About Trac</a></li></ul> </div> </div> <div id="mainnav" class="nav"> <ul><li class="active first"><a href="/wiki">Wiki</a></li><li ><a href="/timeline">Timeline</a></li><li ><a href="/roadmap">Roadmap</a></li><li ><a href="/browser">Browse Source</a></li><li ><a href="/report">View Tickets</a></li><li ><a href="/wiki/NewTicket">New Ticket</a></li><li class="last"><a href="/search">Search</a></li></ul> </div> <div id="main" > <div id="pagepath" class="noprint"> <a class="pathentry first" title="View WikiStart" href="/wiki">wiki:</a><a href="/wiki/TracRevisionLog" title="View TracRevisionLog" class="pathentry">TracRevisionLog</a></div> <div id="ctxtnav" class="nav"> <h2>Context Navigation</h2> <ul> <li class="first"><span id="vote" title="Vote count (+1, -1)"><img alt="Up-vote" src="/chrome/vote/aupgray.png" /><span id="votes">+0</span><img alt="Down-vote" src="/chrome/vote/adownmod.png" /></span></li> <li ><a href="/wiki/WikiStart">Start Page</a></li> <li ><a href="/wiki/TitleIndex">Index</a></li> <li class="last"><a href="/wiki/TracRevisionLog?action=history">History</a></li> </ul> <hr /> </div>  <div id="content" class="wiki narrow"> <div class="wikipage searchable"> <div id="wikipage" class="trac-content borderless"><div class="wikiextras box shadow icon information yellow"><p> This page documents the 1.4 (latest stable) release. Documentation for other releases can be found <a class="wiki" href="/wiki/TitleIndex#TracGuide:BackupandTranslations">here</a>. </p> </div><h1 class="section" id="ViewingRevisionLogs">Viewing Revision Logs</h1> <p> </p><div class="wiki-toc"><h4>Table of Contents</h4><ul><li class="False"><a class="False" href="/wiki/TracGuide">Index</a></li><li class="False"><a class="False" href="/wiki/TracInstall">Installation</a></li><li class="False"><a class="False" href="/wiki/TracInterfaceCustomization">Customization</a></li><li class="False"><a class="False" href="/wiki/TracPlugins">Plugins</a></li><li class="False"><a class="False" href="/wiki/TracUpgrade">Upgrading</a></li><li class="False"><a class="False" href="/wiki/TracIni">Configuration</a></li><li class="False"><a class="False" href="/wiki/TracAdmin">Administration</a></li><li class="False"><a class="False" href="/wiki/TracBackup">Backup</a></li><li class="False"><a class="False" href="/wiki/TracLogging">Logging</a></li><li class="False"><a class="False" href="/wiki/TracPermissions">Permissions</a></li><li class="False"><a class="False" href="/wiki/TracWiki">The Wiki</a></li><li class="False"><a class="False" href="/wiki/WikiFormatting">Wiki Formatting</a></li><li class="False"><a class="False" href="/wiki/TracTimeline">Timeline</a></li><li class="False"><a class="False" href="/wiki/TracBrowser">Repository Browser</a></li><li class="active"><a class="False" href="/wiki/TracRevisionLog">Revision Log</a></li><li class="False"><a class="False" href="/wiki/TracChangeset">Changesets</a></li><li class="False"><a class="False" href="/wiki/TracTickets">Tickets</a></li><li class="False"><a class="False" href="/wiki/TracWorkflow">Workflow</a></li><li class="False"><a class="False" href="/wiki/TracRoadmap">Roadmap</a></li><li class="False"><a class="False" href="/wiki/TracQuery">Ticket Queries</a></li><li class="False"><a class="False" href="/wiki/TracBatchModify">Batch Modify</a></li><li class="False"><a class="False" href="/wiki/TracReports">Reports</a></li><li class="False"><a class="False" href="/wiki/TracRss">RSS Support</a></li><li class="False"><a class="False" href="/wiki/TracNotification">Notification</a></li></ul></div><p> </p> <p> Each path in the <em>Repository Browser</em> contains a contextual navigation link to the <em>Revision Log</em>. The <em>Revision Log</em> displays a list of the most recent changesets in which the current path or any other path below it has been modified. </p> <h2 class="section" id="TheRevisionLogForm">The Revision Log Form</h2> <p> It is possible to set the revision at which the revision log should start, using the <em>View log starting at</em> field. An empty value or a value of <em>head</em> is interpreted as the newest changeset. </p> <p> It is also possible to specify the revision at which the log should stop, using the <em>Back to</em> field. By default it is empty, which means the revision log will show the <a class="wiki" href="/wiki/TracIni#revisionlog-default_log_limit-option">default log limit</a>, which defaults to the latest 100 revisions. </p> <p> There are three modes of operation of the revision log. </p> <p> By default, the revision log <em>stops on copy</em>, which means that whenever an <em>Add</em>, <em>Copy</em> or <em>Rename</em> operation is detected, no older revision will be shown. That's very convenient when working with branches, as one only sees the history for that branch. </p> <p> It is also possible to indicate that one wants include what happened before a <em>Copy</em> or <em>Rename</em> change, by selecting the <em>Follow copies</em> mode. This will continue to list all revisions across copies and renames. Each time the name of the path changes, there will be an additional indentation level. That way, the changes on the different paths are easily grouped together visually. </p> <p> It is even possible to go past an <em>Add</em> change, in order to see if there has been a <em>Delete</em> change on that path, before that <em>Add</em>. This mode is labeled <em>Show only adds, moves and deletes</em>. The operation can be quite resource intensive and therefore take some time to display. </p> <p> Finally, there's a checkbox <em>Show full log messages</em>, which controls whether the full content of the commit log message should be displayed for each change, or only a shortened version of it. </p> <h2 class="section" id="TheRevisionLogInformation">The Revision Log Information</h2> <p> For each revision log entry, the following columns are displayed: </p> <ol><li>The first column contains a pair of radio buttons and should be used for selecting the <em>old</em> and the <em>new</em> revisions that will be used for <a class="wiki" href="/wiki/TracRevisionLog#InspectingChangesBetweenRevisions">viewing the actual changes</a>. </li><li>A color code (similar to the one used for the <a class="wiki" href="/wiki/TracChangeset#ChangesetHeader">changesets</a>) indicates the kind of change. Clicking on this column refreshes the revision log so that it restarts with this change. </li><li>The <strong>Revision</strong> number, displayed as <code>@xyz</code>. This is a link to the <a class="wiki" href="/wiki/TracBrowser">TracBrowser</a>, using the displayed revision as the base line. Next to it, you can see a little "wheel" icon <a href="/chrome/site/../common/changeset.png" style="padding:0; border:none"><img alt="changeset.png" src="/chrome/site/../common/changeset.png" title="changeset.png" /></a>, which is clickable and leads to the <a class="wiki" href="/wiki/TracChangeset">TracChangeset</a> view for that revision. </li><li>The <strong>Age</strong>/<strong>Date</strong> at which the change was made. Depending on your <a href="/prefs/localization">session preference</a>, the date is displayed in either <em>Relative</em> or <em>Absolute</em> format. <ul><li><em>Relative</em> format shows the <strong>Age</strong>: the time elapsed as the number of hours, days, weeks, months, or years. </li><li><em>Absolute</em> format shows the <strong>Date</strong> of the revision as a datetime. </li></ul></li><li>The <strong>Author</strong> of the change. </li><li>The <strong>Log Message</strong>, which contains either the truncated or full commit log message, depending on the value of the <em>Show full log messages</em> checkbox in the form above. </li></ol><h2 class="section" id="InspectingChangesBetweenRevisions">Inspecting Changes Between Revisions</h2> <p> The <em>View changes…</em> buttons (placed above and below the list of changes, on the left side) will show the set of differences corresponding to the aggregated changes starting from the <em>old</em> revision (first radio-button) to the <em>new</em> revision (second radio-button), in the <a class="wiki" href="/wiki/TracChangeset">TracChangeset</a> view. </p> <p> Note that the <em>old</em> revision doesn't need to be actually <em>older</em> than the <em>new</em> revision: it simply gives a base for the diff. It's therefore entirely possible to easily generate a <em>reverse diff</em>, for reverting what has been done in the given range of revisions. </p> <p> Finally, if the two revisions are identical, the corresponding changeset will be shown. This has the same effect as clicking on the changeset number. </p> <h2 class="section" id="AlternativeFormats">Alternative Formats</h2> <h3 class="section" id="TheChangeLogText">The ChangeLog Text</h3> <p> At the bottom of the page, there's a <em>ChangeLog</em> link that will show the range of revisions as currently shown, but as a simple text, matching the usual conventions for ChangeLog files. </p> <h3 class="section" id="RSSSupport">RSS Support</h3> <p> The revision log also provides an RSS feed to monitor the changes. To subscribe to an RSS feed for a file or directory, open its revision log in the browser and click the orange 'XML' icon at the bottom of the page. For more information on RSS support in Trac, see <a class="wiki" href="/wiki/TracRss">TracRss</a>. </p> <hr /> <p> See also: <a class="wiki" href="/wiki/TracBrowser">TracBrowser</a>, <a class="wiki" href="/wiki/TracChangeset">TracChangeset</a> </p> </div> <div class="trac-modifiedby"> <span> <a href="/wiki/TracRevisionLog?action=diff&version=15" title="Version 15 by trac">Last modified</a> <a class="timeline" href="/timeline?from=2019-10-15T06%3A36%3A16%2B02%3A00&precision=second" title="See timeline at Oct 15, 2019, 6:36:16 AM">5 years ago</a> </span> <span class="trac-print"> Last modified on Oct 15, 2019, 6:36:16 AM </span> </div> </div> <div id="attachments"> </div> <div class="buttons"> <form method="get" action="/wiki/TracRevisionLog" id="modifypage"> <div> <input type="hidden" name="action" value="edit" /> <input type="submit" value="Edit this page" /> </div> </form> <form method="get" action="/attachment/wiki/TracRevisionLog/" id="attachfile"> <div> <input type="hidden" name="action" value="new" /> <input type="submit" id="attachfilebutton" value="Attach file"/> </div> </form> </div> <div class="trac-help"> <strong>Note:</strong> See <a href="/wiki/TracWiki">TracWiki</a> for help on using the wiki. </div> </div>  <div id="altlinks"> <h3>Download in other formats:</h3> <ul> <li class="last first"> <a rel="nofollow" href="/wiki/TracRevisionLog?format=txt" class=""> Plain Text</a> </li> </ul> </div>   </div> <div id="footer"><hr/> <a id="tracpowered" href="https://trac.edgewall.org/" ><img src="/chrome/common/trac_logo_mini.png" height="30" width="107" alt="Trac Powered"/></a> <p class="left"> Powered by <a href="/about"><strong>Trac 1.4.3</strong></a> <br /> By <a href="http://www.edgewall.org/">Edgewall Software</a> . </p> <p class="right">Visit the Trac open source project at<br /><a href="//trac.edgewall.org/">https://trac.edgewall.org/</a></p> </div>   </div> </div> </div> <div id="ew-footer"> <p><a href="mailto:info@edgewall.com">info@edgewall.com</a></p> <p>Copyright © 2003-2024 Edgewall Software. All rights reserved.</p> </div> <div id="right"> <div id="ohloh-badge"> <a href="//www.openhub.net/p/trac"> <img src="//www.openhub.net/p/trac/widgets/project_thin_badge.gif" /> </a> </div> <script type="text/javascript"></script> <script type="text/javascript" src="//pagead2.googlesyndication.com/pagead/show_ads.js"> </script> </div>    </body> </html>

CINXE.COM

TracRevisionLog – The Trac Project