Merge lp:~javier.collado/utah/docstrings-use-raises-instead-of-throws into lp:utah

[Javier Collado]

This branch just replaces 'throws' with 'raises' in docstrings.

This is in line with sphinx documentation
(http://sphinx-doc.org/domains.html#info-field-lists) and looks more consistent
with the python syntax for exceptions.

[lp:~javier.collado/utah/docstrings-use-raises-instead-of-throws]

762. By Javier Collado on 2012-11-29

Replace :return: with :returns:

This is to be consistent with the rest of the docstrings.

[Javier Collado (javier.collado)]

I realized that in some place I was using :return: instead of :returns:, so I
changed that as well to be consistent.

[Max Brustkern (nuclearbob)]

Looks good to me.

review: Approve

=== modified file 'utah/preseed.py'
--- utah/preseed.py	2012-11-14 19:55:36 +0000
+++ utah/preseed.py	2012-11-29 10:17:22 +0000
@@ -109,9 +109,9 @@
 
         :param lines: Any iterable that yields preseed file configuration lines
         :type lines: iterable
-        :return: Preseed file object with information parsed
+        :returns: Preseed file object with information parsed
         :rtype: :class:`Preseed`
-        :throws ParsingError:
+        :raises ParsingError:
             If there's a problem parsing some configuration lines, this
             exception will be raised with the line number where the problem was
             detected in the message.
@@ -320,7 +320,7 @@
         :type old_text: `string` | `None`
         :param new_text: New property text
         :type new_text: `string`
-        :throws DuplicatedQuestionName:
+        :raises DuplicatedQuestionName:
             If the updated property is `qname` and the new text is already
             taken by other section which would break the access to a section by
             the question name.
@@ -694,7 +694,7 @@
 
     :parameter raw_lines: An iterable that yields one line at a time
     :type raw_lines: `iterable`
-    :throws ParsingError:
+    :raises ParsingError:
         If the configuration lines don't follow the expected format above, this
         exception will be raised.
 

=== modified file 'utah/url.py'
--- utah/url.py	2012-11-27 09:58:06 +0000
+++ utah/url.py	2012-11-29 10:17:22 +0000
@@ -64,7 +64,7 @@
         :type url: `basestring`
         :returns: The url passed as argument when it's valid and readable.
         :rtype: `basestring`
-        :throws URLNotFound:
+        :raises URLNotFound:
             When there's a problem opening the URL or isn't found.
 
         :Example:
@@ -111,9 +111,9 @@
                 can be used to open the file the same way as
                 any other files.
         :rtype: `basestring`
-        :throws URLNotFound:
+        :raises URLNotFound:
             when the path to the file doesn't exist.
-        :throws URLNotReadable:
+        :raises URLNotReadable:
             when the user doesn't have read permissions to open the file.
 
         :Example:
@@ -161,7 +161,7 @@
     :type url: `basestring`
     :returns: URL or path to local file
     :rtype: `basestring`
-    :throws argparse.ArgumentTypeError:
+    :raises argparse.ArgumentTypeError:
 
         when the URL is invalid or unreadable. In any case, the error message
         will provide information to be displayed by the