Fix some epydoc warnings

Git-Dch: Ignore

4 files changed, 22 insertions, 17 deletions

diff --git a/gbp/command_wrappers.py b/gbp/command_wrappers.py
index 49fc966d..59d1d8af 100644
--- a/gbp/command_wrappers.py
+++ b/gbp/command_wrappers.py
@@ -301,7 +301,9 @@ def copy_from(orig_dir, filters=[]):
     """
     copy a source tree over via tar
     @param orig_dir: where to copy from
-    @param exclude: tar exclude pattern
+    @type orig_dir: string
+    @param filters: tar exclude pattern
+    @type filters: list of strings
     @return: list of copied files
     @rtype: list
     """
diff --git a/gbp/config.py b/gbp/config.py
index be20784f..d4694b0e 100644
--- a/gbp/config.py
+++ b/gbp/config.py
@@ -259,11 +259,11 @@ class GbpOptionParser(OptionParser):
     def add_config_file_option(self, option_name, dest, help=None, **kwargs):
         """
         set a option for the command line parser, the default is read from the config file
-        @var option_name: name of the option
+        @param option_name: name of the option
         @type option_name: string
-        @var dest: where to store this option
+        @param dest: where to store this option
         @type dest: string
-        @var help: help text
+        @param help: help text
         @type help: string
         """
         if not help:
@@ -281,11 +281,11 @@ class GbpOptionGroup(OptionGroup):
     def add_config_file_option(self, option_name, dest, help=None, **kwargs):
         """
         set a option for the command line parser, the default is read from the config file
-        @var option_name: name of the option
+        @param option_name: name of the option
         @type option_name: string
-        @var dest: where to store this option
+        @param dest: where to store this option
         @type dest: string
-        @var help: help text
+        @param help: help text
         @type help: string
         """
         if not help:
diff --git a/gbp/deb.py b/gbp/deb.py
index 547fbb75..6da509e0 100644
--- a/gbp/deb.py
+++ b/gbp/deb.py
@@ -480,7 +480,7 @@ def parse_uscan(out):
     (True, None). Returns (False, None) if the current version is up to date.
 
     @param out: uscan output
-    @param type: string
+    @type out: string
     @return: status and tarball name
     @rtype: tuple
     >>> parse_uscan("<status>up to date</status>")
@@ -545,9 +545,9 @@ def guess_upstream_version(archive, extra_regex=r''):
     """
     guess the package name and version from the filename of an upstgream
     archive. Returns a tuple with package name and version, or None.
-    @archive: filename to guess to version for
-    @extra_regex: additional regex to apply, needs a 'package' and a
-    'version' group
+    @param archive: filename to guess to version for
+    @param extra_regex: additional regex to apply, needs a 'package' and a
+                        'version' group
 
     >>> guess_upstream_version('foo-bar_0.2.orig.tar.gz')
     ('foo-bar', '0.2')
@@ -566,7 +566,6 @@ def guess_upstream_version(archive, extra_regex=r''):
     ('kvm', '87+dfsg')
     >>> guess_upstream_version('foo-Bar_0.2.orig.tar.gz')
     >>> guess_upstream_version('foo-Bar-a.b.tar.gz')
-
     """
     version_chars = r'[a-zA-Z\d\.\~\-\:\+]'
     extensions = r'\.tar\.(gz|bz2)'
diff --git a/gbp/git.py b/gbp/git.py
index ec0b9068..e184c281 100644
--- a/gbp/git.py
+++ b/gbp/git.py
@@ -113,7 +113,7 @@ class GitRepository(object):
         You only need to use this funciton if you also need to check for legacy
         tags.
 
-        @param pattern: tag pattern
+        @param format: tag pattern
         @param version: debian version number
         @return: sha1 of the version tag
         """
@@ -384,13 +384,17 @@ class GitRepository(object):
                    author={}, committer={}):
         """Replace the current tip of branch 'branch' with the contents from 'unpack_dir'
            @param unpack_dir: content to add
+           @type unpack_dir: striing
            @param msg: commit message to use
+           @type msg: string
            @param branch: branch to add the contents of unpack_dir to
-           @param parents: additional parents of this commit
-           @param author: commit with author information from author
+           @type branch: string
+           @param other_parents: additional parents of this commit
+           @type other_parents: list string
+           @param author: author information to use for commit
            @type author: dict with keys 'name', 'email', 'date'
-           @param committer_author: commit with committer information from committer
-           @type comitter: dict with keys 'name', 'email', 'date'"""
+           @param committer: committer information to use for commit
+           @type committer: dict with keys 'name', 'email', 'date'"""
 
         self.__check_path()
         git_index_file = os.path.join(self.path, '.git', 'gbp_index')