diff mercurial/context.py @ 11539:a463e3c50212 stable

cmp: document the fact that we return True if content is different This is similar to the __builtin__.cmp behaviour, but still not straightforward, as the dailylife meaning of a comparison usually is "find out if they are different".
author Nicolas Dumazet <nicdumz.commits@gmail.com>
date Fri, 09 Jul 2010 11:02:39 +0900
parents 16fe98804fd8
children ce95d8b87d22
line wrap: on
line diff
--- a/mercurial/context.py	Fri Jul 09 11:59:48 2010 +0900
+++ b/mercurial/context.py	Fri Jul 09 11:02:39 2010 +0900
@@ -353,6 +353,10 @@
         return self._filelog.size(self._filerev)
 
     def cmp(self, text):
+        """compare text with stored file revision
+
+        returns True if text is different than what is stored.
+        """
         return self._filelog.cmp(self._filenode, text)
 
     def renamed(self):
@@ -932,6 +936,10 @@
             return (t, tz)
 
     def cmp(self, text):
+        """compare text with disk content
+
+        returns True if text is different than what is on disk.
+        """
         return self._repo.wread(self._path) != text
 
 class memctx(object):