   # can be an array of strings containing the reference names.
   getReferences: -> @getRepo().getReferences()
 
-  # Public: ?
+  # Public: Returns the number of commits behind the current branch is from the
+  # default remote branch.
   getAheadBehindCount: (reference) -> @getRepo().getAheadBehindCount(reference)
 
-  # Public: ?
+  # Public: Returns true if the given branch exists.
   hasBranch: (branch) -> @getReferenceTarget("refs/heads/#{branch}")?
 
-  # Private:
+  # Private: 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)

  # Returns a String.
  getUpstreamBranch: -> @getRepo().getUpstreamBranch()

  # Public: ?
  getReferenceTarget: (reference) -> @getRepo().getReferenceTarget(reference)

  # Public: Gets all the local and remote references.

      @subscribeToBuffer(buffer) for buffer in project.getBuffers()
      @subscribe project, 'buffer-created', (buffer) => @subscribeToBuffer(buffer)

  # Private: Subscribes to buffer events.
  subscribeToBuffer: (buffer) ->
    bufferStatusHandler = =>
      if path = buffer.getPath()
