--- a/mercurial/localrepo.py	Sun Jan 12 23:28:21 2014 +0100
+++ b/mercurial/localrepo.py	Thu Nov 21 15:17:18 2013 -0500
@@ -655,7 +655,8 @@
         return sorted(marks)
 
     def branchmap(self):
-        '''returns a dictionary {branch: [branchheads]}'''
+        '''returns a dictionary {branch: [branchheads]} with branchheads
+        ordered by increasing revision number'''
         branchmap.updatecache(self)
         return self._branchcaches[self.filtername]