Add a few docstrings. If someone could complete that, it would be great

Signed-off-by: Joerg Jaspert <joerg@debian.org>

diff --git a/daklib/regexes.py b/daklib/regexes.py
index daf16ff653006220e35a23d4af38b3dc2c115fed..3d7d7a8bf534031781ef697776784502db9fbe98 100755 (executable)
--- a/daklib/regexes.py
+++ b/daklib/regexes.py
@@ -7,7 +7,7 @@ Central repository of regexes for dak
 @contact: Debian FTP Master <ftpmaster@debian.org>
 @copyright: 2001, 2002, 2003, 2004, 2005, 2006  James Troup <james@nocrew.org>
 @copyright: 2009  Mark Hymers <mhy@debian.org>
-@copyright: 2009  Joerg Jaspert <joerg@debian.org>
+@copyright: 2009, 2010  Joerg Jaspert <joerg@debian.org>
 @license: GNU General Public License version 2 or later
 """
 
@@ -29,12 +29,19 @@ Central repository of regexes for dak
 
 import re
 
+#: Is it a number?
 re_isanum = re.compile (r"^\d+$")
+
+#: Looking for the default reply
 re_default_answer = re.compile(r"\[(.*)\]")
+#: Used in build_summaries to make changes output look better
 re_fdnic = re.compile(r"\n\n")
+#: Detect a binnmu
 re_bin_only_nmu = re.compile(r"\+b\d+$")
 
+#: To sort out comment lines
 re_comments = re.compile(r"\#.*")
+#: To ignore comment and whitespace lines.
 re_whitespace_comment = re.compile(r"^\s*(#|$)")
 re_no_epoch = re.compile(r"^\d+\:")
 re_no_revision = re.compile(r"-[^-]+$")
@@ -47,6 +54,7 @@ re_orig_source_ext = re.compile(orig_source_ext_re + "$")
 re_source_ext = re.compile("(" + orig_source_ext_re + r"|debian\.tar\.(?:gz|bz2)|diff\.gz|tar\.(?:gz|bz2)|dsc)$")
 re_issource = re.compile(r"(.+)_(.+?)\." + re_source_ext.pattern)
 re_is_orig_source = re.compile (r"(.+)_(.+?)\.orig(?:-.+)?\.tar\.(?:gz|bz2)$")
+#re_is_orig_source = re.compile (r"(.+)_(.+?)\.(?:orig\.)?tar\.(?:gz|bz2)$")
 
 re_single_line_field = re.compile(r"^(\S*?)\s*:\s*(.*)")
 re_multi_line_field = re.compile(r"^\s(.*)")