From 03dc41bff97fe273f1a29746fab15aa0d4f783cd Mon Sep 17 00:00:00 2001
From: Gerald Britton <gerald.britton@gmail.com>
Date: Wed, 9 Sep 2009 14:43:55 +0000
Subject: [PATCH] Documentation updates

svn: r13183
---
 src/gen/db/upgrade.py | 3 +++
 src/gen/db/write.py   | 9 +++++++++
 2 files changed, 12 insertions(+)

diff --git a/src/gen/db/upgrade.py b/src/gen/db/upgrade.py
index 63c35418e..eae42a132 100644
--- a/src/gen/db/upgrade.py
+++ b/src/gen/db/upgrade.py
@@ -22,6 +22,9 @@
 
 from __future__ import with_statement
 from gen.db import BSDDBTxn
+"""
+upgrade
+"""
 
 def gramps_upgrade_14(self):
     """Upgrade database from version 13 to 14."""
diff --git a/src/gen/db/write.py b/src/gen/db/write.py
index 3b890bfc4..05419ac53 100644
--- a/src/gen/db/write.py
+++ b/src/gen/db/write.py
@@ -38,6 +38,7 @@ import time
 import locale
 import bisect
 from types import InstanceType
+from functools import wraps
 
 from gettext import gettext as _
 from bsddb import dbshelve, db
@@ -208,6 +209,7 @@ class GrampsDBDir(GrampsDbRead, Callback, UpdateCallback):
         one of the exceptions in DBERRS, the error is logged and a DbError
         exception is raised.
         """
+        @wraps(func)
         def try_(*args, **kwargs):
             try:
                 return func(*args, **kwargs)
@@ -1284,9 +1286,15 @@ class GrampsDBDir(GrampsDbRead, Callback, UpdateCallback):
 
     @catch_db_error
     def build_surname_list(self):
+        """
+        Build surname list for use in autocompletion
+        """
         self.surname_list = sorted(map(unicode, set(self.surnames.keys())), key=locale.strxfrm)
 
     def add_to_surname_list(self, person, batch_transaction):
+        """
+        Add surname to surname list
+        """
         if batch_transaction:
             return
         name = unicode(person.get_primary_name().get_surname())
@@ -1789,3 +1797,4 @@ if __name__ == "__main__":
             print key, person.get_primary_name().get_name(),
 
     print d.surnames.keys()
+    print d.remove_from_surname_list.__doc__