 
   # Public: Gets all the local and remote references.
   #
-  # Returns an object with three keys: `heads`, `remotes`, and `tags`. Each key
-  # can be an array of strings containing the reference names.
+  # Returns an {Object} with the following keys:
+  #  :heads - An {Array} of head reference names.
+  #  :remotes - An {Array} of remote reference names.
+  #  :tags - An {Array} of tag reference names.
   getReferences: -> @getRepo().getReferences()
 
   # Public: Returns the number of commits behind the current branch is from the
-  # default remote branch.
+  # its upstream remote branch.
   getAheadBehindCount: (reference) -> @getRepo().getAheadBehindCount(reference)
 
   # Public: Returns true if the given branch exists.
   hasBranch: (branch) -> @getReferenceTarget("refs/heads/#{branch}")?
 
-  # Private: Refreshes the current git status in an outside process and
-  # asynchronously updates the relevant properties.
+  # Refreshes the current git status in an outside process and asynchronously
+  # updates the relevant properties.
   refreshStatus: ->
     @statusTask = Task.once require.resolve('./repository-status-handler'), @getPath(), ({statuses, upstream, branch}) =>
       statusesUnchanged = _.isEqual(statuses, @statuses) and _.isEqual(upstream, @upstream) and _.isEqual(branch, @branch)

  # Public: Returns the upstream branch for the current HEAD, or null if there
  # is no upstream branch for the current HEAD.
  #
  # Returns a String branch name such as `refs/remotes/origin/master`
  getUpstreamBranch: -> @getRepo().getUpstreamBranch()

  # Public: Returns the current SHA for the given reference.


  # Public: Checks out a branch in your repository.
  #
  # reference - The String reference to checkout
  # create -  A Boolean value which, if true creates the new reference if it
  #           doesn't exist.
  #
  # Returns a Boolean that's true if the method was successful.
  checkoutReference: (reference, create) ->
