     else
       fullPath
 
-  # Retrieves the file entries in the directory.
+  # Public: Reads file entries in this directory from disk.
   #
-  # This does follow symlinks.
+  # Note: It follows symlinks.
   #
   # Returns an {Array} of {Files}.
   getEntries: ->

  path: null
  realPath: null

  ### Public ###

  # Creates a new directory.
  #
  # path - A {String} representing the file directory
  # symlink - A {Boolean} indicating if the path is a symlink (default: false)
  constructor: (@path, @symlink=false) ->

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

  # Retrieves the directory's path.
  #
  # Returns a {String}.
  getPath: -> @path

  # Retrieves this directory's real path.
  #
  # Returns a {String}.
  getRealPath: ->
    unless @realPath?
      try

        @realPath = @path
    @realPath

  # Public: Returns whether the given path is inside this directory.
  contains: (pathToCheck) ->
    return false unless pathToCheck

