   # This compares the working directory contents of the path to the `HEAD`
   # version.
   #
-  # * path:
-  #   The String path to check
-  #
-  # Returns an object with two keys, `added` and `deleted`. These will always
-  # be greater than 0.
+  # path - The {String} path to check.
+  #
+  # Returns an {Object} with the following keys:
+  #   :added - The {Number} of added lines.
+  #   :deleted - The {Number} of deleted lines.
   getDiffStats: (path) -> @getRepo().getDiffStats(@relativize(path))
 
-  # Public: Identifies if a path is a submodule.
-  #
-  # * path:
-  #   The String path to check
-  #
-  # Returns a Boolean.
+  # Public: Is the given path a submodule in the repository?
+  #
+  # path - The {String} path to check.
+  #
+  # Returns a {Boolean}.
   isSubmodule: (path) -> @getRepo().isSubmodule(@relativize(path))
 
-  # Public: Retrieves the status of a directory.
-  #
-  # * path:
-  #   The String path to check
-  #
-  # Returns a Number representing the status.
+  # Public: Get the status of a directory in the repository's working directory.
+  #
+  # path - The {String} path to check.
+  #
+  # Returns a {Number} representing the status. This value can be passed to
+  # {.isStatusModified} or {.isStatusNew} to get more information.
   getDirectoryStatus: (directoryPath)  ->
     {sep} = require 'path'
     directoryPath = "#{directoryPath}#{sep}"

    else
      false

  path: null
  statuses: null
  upstream: null
  branch: null
  statusTask: null

  # Private: Creates a new `Git` object.
  #
  # * path: The {String} representing the path to your git working directory
  # * options:
  #    + refreshOnWindowFocus: If `true`, {#refreshIndex} and {#refreshStatus}
  #      are called on focus
  #    + project: A project that supplies buffers that will be monitored for
  #      save and reload events to trigger status refreshes.
  constructor: (path, options={}) ->
    @repo = GitUtils.open(path)
    unless @repo?


  # 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) ->
