# HG changeset patch
# User Benoit Boissinot <benoit.boissinot@ens-lyon.org>
# Date 1157799368 -7200
# Node ID ad6aecaf4eed0d0a0459f5d8218766ec6e404083
# Parent  1a792e4a1f3a4b7e5a57951388f29b3ed20d04b4
document changelog format

diff -r 1a792e4a1f3a -r ad6aecaf4eed 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")