 class Directory
   Emitter.includeInto(this)
 
-  path: null
   realPath: null
 
   # Public: Configures a new Directory instance, no files are accessed.
   #
-  # * path:
-  #   A String containing the absolute path to the directory.
-  # + symlink:
-  #   A Boolean indicating if the path is a symlink (defaults to false).
+  # path - A {String} containing the absolute path to the directory.
+  # symlink - A {Boolean} indicating if the path is a symlink (default: false).
   constructor: (@path, @symlink=false) ->
     @on 'first-contents-changed-subscription-will-be-added', =>
       # Triggered by emissary, when a new contents-changed listener attaches


  # Public: Reads file entries in this directory from disk asynchronously.
  #
  # * callback: A function to call with an Error as the first argument and
  #   an {Array} of {File} and {Directory} objects as the second argument.
  getEntries: (callback) ->
    fs.list @path, (error, entries) ->
      return callback(error) if error?

      # Triggered by emissary, when the last contents-changed listener detaches
      @unsubscribeFromNativeChangeEvents()

  # Public: Returns the {String} basename of the directory.
  getBaseName: ->
    path.basename(@path)

