X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=daklib%2Fformats.py;h=bcd42f61b01aec959d8be734173d2627a9dffbae;hb=46c004587d4467079853324c53a927c25823f5fd;hp=aaad2715aac119bd40766d1cef333f9cf2df36df;hpb=e102ad02c396868d6f6c514f42a641e78f7fca9b;p=dak.git

diff --git a/daklib/formats.py b/daklib/formats.py
index aaad2715..bcd42f61 100644
--- a/daklib/formats.py
+++ b/daklib/formats.py
@@ -1,3 +1,36 @@
+#!/usr/bin/python
+
+""" Helper functions for the various changes formats
+
+@contact: Debian FTPMaster <ftpmaster@debian.org>
+@copyright: 2009, 2010  Joerg Jaspert <joerg@debian.org>
+@copyright: 2009  Chris Lamb <lamby@debian.org>
+@license: GNU General Public License version 2 or later
+"""
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+################################################################################
+
+# <mhy> !!!!11111iiiiiioneoneoneone
+# <dak> mhy: Error: "!!!11111iiiiiioneoneoneone" is not a valid command.
+# <mhy> dak: oh shut up
+# <dak> mhy: Error: "oh" is not a valid command.
+
+################################################################################
+
 from regexes import re_verwithext
 from dak_exceptions import UnknownFormatError
 
@@ -12,12 +45,20 @@ def parse_format(txt):
     (8, 4, 'hardy')
 
     If the format doesn't match these forms, raises UnknownFormatError.
+
+    @type txt: string
+    @param txt: Format string to parse
+
+    @rtype: tuple
+    @return: Parsed format
+
+    @raise UnknownFormatError: Unknown Format: line
     """
 
     format = re_verwithext.search(txt)
 
     if format is None:
-        raise UnknownFormatError, txt
+        raise UnknownFormatError(txt)
 
     format = format.groups()
 
@@ -39,7 +80,7 @@ def validate_changes_format(format, field):
     """
 
     if (format < (1, 5) or format > (1, 8)):
-        raise UnknownFormatError, repr(format)
+        raise UnknownFormatError(repr(format))
 
     if field != 'files' and format < (1, 8):
-        raise UnknownFormatError, repr(format)
+        raise UnknownFormatError(repr(format))