Quick spelling clean-up in the auto-bisect code.

tools/auto_bisect/source_control.py

 # Copyright 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 """This module contains the SourceControl class and related functions."""
 
 import os
 
 from . import bisect_utils
 
@@ skipping 18 matching lines @@
 
 class SourceControl(object):
   """SourceControl is an abstraction over the source control system."""
 
   def __init__(self):
     super(SourceControl, self).__init__()
 
   def SyncToRevisionWithGClient(self, revision):
     """Uses gclient to sync to the specified revision.
 
-    ie. gclient sync --revision <revision>
+    This is like running gclient sync --revision <revision>.
 
     Args:
-      revision: The git SHA1 or svn CL (depending on workflow).
+      revision: A git SHA1 hash or SVN revision number (depending on workflow).
 
     Returns:
       The return code of the call.
     """
     return bisect_utils.RunGClient(['sync', '--verbose', '--reset', '--force',
         '--delete_unversioned_trees', '--nohooks', '--revision', revision])
 
   def SyncToRevisionWithRepo(self, timestamp):
-    """Uses repo to sync all the underlying git depots to the specified
-    time.
+    """Uses the repo command to sync all the underlying git depots to the
+    specified time.
 
     Args:
-      timestamp: The unix timestamp to sync to.
+      timestamp: The Unix timestamp to sync to.
 
     Returns:
       The return code of the call.
     """
     return bisect_utils.RunRepoSyncAtTimestamp(timestamp)
 
 
 class GitSourceControl(SourceControl):
   """GitSourceControl is used to query the underlying source control."""
 
@@ skipping 154 matching lines @@
       return int(svn_revision)
 
     return None
 
   def QueryRevisionInfo(self, revision, cwd=None):
     """Gathers information on a particular revision, such as author's name,
     email, subject, and date.
 
     Args:
       revision: Revision you want to gather information on.
+
     Returns:
       A dict in the following format:
       {
         'author': %s,
         'email': %s,
         'date': %s,
         'subject': %s,
         'body': %s,
       }
     """
@@ skipping 12 matching lines @@
   def CheckoutFileAtRevision(self, file_name, revision, cwd=None):
     """Performs a checkout on a file at the given revision.
 
     Returns:
       True if successful.
     """
     return not bisect_utils.RunGit(
         ['checkout', revision, file_name], cwd=cwd)[1]
 
   def RevertFileToHead(self, file_name):
-    """Unstages a file and returns it to HEAD.
+    """Un-stages a file and resets the file's state to HEAD.
 
     Returns:
       True if successful.
     """
     # Reset doesn't seem to return 0 on success.
     bisect_utils.RunGit(['reset', 'HEAD', file_name])
 
     return not bisect_utils.RunGit(['checkout', bisect_utils.FILE_DEPS_GIT])[1]
 
   def QueryFileRevisionHistory(self, filename, revision_start, revision_end):
     """Returns a list of commits that modified this file.
 
     Args:
         filename: Name of file.
         revision_start: Start of revision range.
         revision_end: End of revision range.
 
     Returns:
         Returns a list of commits that touched this file.
     """
     cmd = ['log', '--format=%H', '%s~1..%s' % (revision_start, revision_end),
            filename]
     output = bisect_utils.CheckRunGit(cmd)
 
     return [o for o in output.split('\n') if o]