Rename Repository.filelog() to Repository.itemlog() (Subversion

supports logs on directories, too, ya know).  And make some other
little documentation changes.

* viewcvs/lib/vclib/__init__.py
  (Repository.itemlog): Was Repository.filelog().
  (Revision.__init__): Document the input parameters.

* viewcvs/lib/vclib/bincvs/__init__.py
  (BinCVSRepository.itemlog): Was BinCVSRepository.filelog().

* viewcvs/lib/vclib/ccvs/__init__.py
  (CCVSRepository.itemlog): Was CCVSRepository.filelog().

* viewcvs/lib/vclib/svn/__init__.py
  (SubversionRepository.itemlog): Was SubversionRepository.filelog().

* viewcvs/lib/vclib/svn_ra/__init__.py
  (SubversionRepository.itemlog): Was SubversionRepository.filelog().

* viewcvs/lib/viewcvs.py
  (view_markup, view_log): Update calls to Repository.itemlog() (from
    Repository.filelog()).

* viewcvs/lib/cvsdb.py
  (GetCommitListFromRCSFile): Update calls to Repository.itemlog()
    (from Repository.filelog()).


git-svn-id: http://viewvc.tigris.org/svn/viewvc/trunk@1050 8cb11bc2-c004-0410-86c3-e597b4017df7

lib/cvsdb.py

@@ -672,7 +672,7 @@ def GetCommitListFromRCSFile(repository, path_parts, revision=None):
     directory = string.join(path_parts[:-1], "/")
     file = path_parts[-1]
 
-    revs = repository.filelog(path_parts, revision, {"cvs_pass_rev": 1})
+    revs = repository.itemlog(path_parts, revision, {"cvs_pass_rev": 1})
     for rev in revs:
         commit = CreateCommit()
         commit.SetRepository(repository.rootpath)

lib/vclib/__init__.py

@@ -80,8 +80,8 @@ class Repository:
     options is a dictionary of implementation specific options
     """
   
-  def filelog(self, path_parts, rev, options):
-    """Retrieve a file's log information
+  def itemlog(self, path_parts, rev, options):
+    """Retrieve an item's log information
 
     The result is a list of Revision objects
 
@@ -105,7 +105,17 @@ class DirEntry:
     self.errors = errors
 
 class Revision:
-  """Instances holds information about file revisions"""
+  """Instances holds information about revisions of versioned resources"""
+
+  """Create a new Revision() item:
+        NUMBER:  Revision in an integer-based, sortable format
+        STRING:  Revision as a string
+        DATE:  Seconds since Epoch (GMT) that this revision was created
+        AUTHOR:  Author of the revision
+        CHANGED:  Lines-changed (contextual diff) information
+        LOG:  Log message associated with the creation of this revision
+        SIZE:  Size (in bytes) of this revision's fulltext (files only)
+  """
   def __init__(self, number, string, date, author, changed, log, size):
     self.number = number
     self.string = string

lib/vclib/bincvs/__init__.py

@@ -189,8 +189,8 @@ class BinCVSRepository(CVSRepository):
       else:
         tags.append(name)
 
-  def filelog(self, path_parts, rev, options):
-    """see vclib.Repository.filelog docstring
+  def itemlog(self, path_parts, rev, options):
+    """see vclib.Repository.itemlog docstring
 
     rev parameter can be a revision number, branch number or tag name
 

lib/vclib/ccvs/__init__.py

@@ -82,8 +82,8 @@ class CCVSRepository(CVSRepository):
       else:
         tags.append(name)
 
-  def filelog(self, path_parts, rev, options):
-    """see vclib.Repository.filelog docstring
+  def itemlog(self, path_parts, rev, options):
+    """see vclib.Repository.itemlog docstring
 
     rev parameter can be a revision number, branch number or tag name
 
@@ -96,7 +96,7 @@ class CCVSRepository(CVSRepository):
     sink = TreeSink()
     rcsparse.Parser().parse(open(path, 'rb'), sink)
     filtered_revs = _file_log(sink.revs.values(), sink.tags,
-                                           sink.default_branch, rev)
+                              sink.default_branch, rev)
     for rev in filtered_revs:
       if rev.prev and len(rev.number) == 2:
         rev.changed = rev.prev.next_changed

lib/vclib/svn/__init__.py

@@ -399,7 +399,7 @@ class SubversionRepository(vclib.Repository):
   def dirlogs(self, path_parts, entries, options):
     get_logs(self, self._getpath(path_parts), entries)
 
-  def filelog(self, path_parts, rev, options):
+  def itemlog(self, path_parts, rev, options):
     full_name = self._getpath(path_parts)
 
     if rev is not None:

lib/vclib/svn_ra/__init__.py

@@ -449,7 +449,7 @@ class SubversionRepository(vclib.Repository):
   def dirlogs(self, path_parts, entries, options):
     get_logs(self, self._getpath(path_parts), entries)
 
-  def filelog(self, path_parts, rev, options):
+  def itemlog(self, path_parts, rev, options):
     full_name = self._getpath(path_parts)
 
     if rev is not None:

lib/viewcvs.py

@@ -1319,7 +1319,7 @@ def view_markup(request):
 
   if cfg.options.show_log_in_markup:
     options = {}
-    revs = request.repos.filelog(request.path_parts, revision, options)
+    revs = request.repos.itemlog(request.path_parts, revision, options)
     entry = revs[-1]
 
     data.update({
@@ -1755,7 +1755,7 @@ def view_log(request):
   else:
     rev = None
 
-  show_revs = request.repos.filelog(request.path_parts, rev, options)
+  show_revs = request.repos.itemlog(request.path_parts, rev, options)
   if logsort == 'date':
     show_revs.sort(logsort_date_cmp)
   elif logsort == 'rev':