document changelog format
authorBenoit Boissinot <benoit.boissinot@ens-lyon.org>
Sat, 09 Sep 2006 12:56:08 +0200
changeset 3077 ad6aecaf4eed
parent 3076 1a792e4a1f3a
child 3078 baa3873eb387
document changelog format
mercurial/changelog.py
--- a/mercurial/changelog.py	Sat Sep 09 12:51:05 2006 +0200
+++ b/mercurial/changelog.py	Sat Sep 09 12:56:08 2006 +0200
@@ -16,6 +16,14 @@
                         defversion)
 
     def extract(self, text):
+        """
+        format used:
+        nodeid\n  : manifest node in ascii
+        user\n    : user, no \n or \r allowed
+        time tz\n : date (time is int or float, timezone is int)
+        files\n\n : files modified by the cset, no \n or \r allowed
+        (.*)      : comment (free text, ideally utf-8)
+        """
         if not text:
             return (nullid, "", (0, 0), [], "")
         last = text.index("\n\n")