# HG changeset patch
# User Patrick Mezard <pmezard@gmail.com>
# Date 1222673436 -7200
# Node ID 0f4564b4cc2c4cdc6a25d5c8a2358ab5e3fe6e10
# Parent  e837f22946432c8b0f7f707abc9cf6448444d35a
convert: improve convert_source documentation

diff -r e837f2294643 -r 0f4564b4cc2c hgext/convert/common.py
--- a/hgext/convert/common.py	Sun Sep 28 20:40:38 2008 +0200
+++ b/hgext/convert/common.py	Mon Sep 29 09:30:36 2008 +0200
@@ -68,17 +68,23 @@
         raise NotImplementedError()
 
     def getfile(self, name, rev):
-        """Return file contents as a string"""
+        """Return file contents as a string. rev is the identifier returned
+        by a previous call to getchanges().
+        """
         raise NotImplementedError()
 
     def getmode(self, name, rev):
-        """Return file mode, eg. '', 'x', or 'l'"""
+        """Return file mode, eg. '', 'x', or 'l'. rev is the identifier
+        returned by a previous call to getchanges().
+        """
         raise NotImplementedError()
 
     def getchanges(self, version):
-        """Returns a tuple of (files, copies)
-        Files is a sorted list of (filename, id) tuples for all files changed
-        in version, where id is the source revision id of the file.
+        """Returns a tuple of (files, copies). 
+
+        files is a sorted list of (filename, id) tuples for all files
+        changed between version and it's first parent returned by
+        getcommit(). id is the source revision id of the file.
 
         copies is a dictionary of dest: source
         """