From 977eff5af10b50ba6e6edb6abc4f40804c418b12 Mon Sep 17 00:00:00 2001
From: "W. Trevor King" <wking@drexel.edu>
Date: Sun, 7 Feb 2010 17:53:53 -0500
Subject: Fixed docstrings so only Sphinx errors are "autosummary" and "missing
 attribute"

---
 libbe/storage/vcs/arch.py | 40 +++++++++++++++++++++++-----------------
 1 file changed, 23 insertions(+), 17 deletions(-)

(limited to 'libbe/storage/vcs/arch.py')

diff --git a/libbe/storage/vcs/arch.py b/libbe/storage/vcs/arch.py
index 38b1d02..3a50414 100644
--- a/libbe/storage/vcs/arch.py
+++ b/libbe/storage/vcs/arch.py
@@ -18,8 +18,9 @@
 # with this program; if not, write to the Free Software Foundation, Inc.,
 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 
-"""
-GNU Arch (tla) backend.
+"""GNU Arch_ (tla) backend.
+
+.. _Arch: http://www.gnu.org/software/gnu-arch/
 """
 
 import codecs
@@ -56,6 +57,8 @@ def new():
     return Arch()
 
 class Arch(base.VCS):
+    """:class:`base.VCS` implementation for GNU Arch.
+    """
     name = 'arch'
     client = client
     _archive_name = None
@@ -90,10 +93,10 @@ class Arch(base.VCS):
         self._add_project_code(path)
 
     def _create_archive(self, path):
-        """
-        Create a temporary Arch archive in the directory PATH.  This
-        archive will be removed by
-          destroy->_vcs_destroy->_remove_archive
+        """Create a temporary Arch archive in the directory PATH.  This
+        archive will be removed by::
+
+            destroy->_vcs_destroy->_remove_archive
         """
         # http://regexps.srparish.net/tutorial-tla/new-archive.html#Creating_a_New_Archive
         assert self._archive_name == None
@@ -109,8 +112,7 @@ class Arch(base.VCS):
                               self._archive_dir, cwd=path)
 
     def _invoke_client(self, *args, **kwargs):
-        """
-        Invoke the client on our archive.
+        """Invoke the client on our archive.
         """
         assert self._archive_name != None
         command = args[0]
@@ -164,16 +166,20 @@ class Arch(base.VCS):
         return '%s/%s' % (self._archive_name, self._project_name)
 
     def _adjust_naming_conventions(self, path):
-        """
-        By default, Arch restricts source code filenames to
-          ^[_=a-zA-Z0-9].*$
-        See
-          http://regexps.srparish.net/tutorial-tla/naming-conventions.html
-        Since our bug directory '.be' doesn't satisfy these conventions,
-        we need to adjust them.
+        """Adjust `Arch naming conventions`_ so ``.be`` is considered source
+        code.
+
+        By default, Arch restricts source code filenames to::
+
+            ^[_=a-zA-Z0-9].*$
 
-        The conventions are specified in
-          project-root/{arch}/=tagging-method
+        Since our bug directory ``.be`` doesn't satisfy these conventions,
+        we need to adjust them.  The conventions are specified in::
+
+            project-root/{arch}/=tagging-method
+
+        .. _Arch naming conventions:
+          http://regexps.srparish.net/tutorial-tla/naming-conventions.html
         """
         tagpath = os.path.join(path, '{arch}', '=tagging-method')
         lines_out = []
-- 
cgit