   # Sets the path for the file.
   setPath: (@path) ->
 
-  # Public: Returns the path for the file.
+  # Public: Returns the {String} path for the file.
   getPath: -> @path
 
-  # Public: Return the filename without any directory information.
+  # Public: Return the {String} filename without any directory information.
   getBaseName: ->
     path.basename(@path)
 


  # Public: Reads the contents of the file.
  #
  # * flushCache:
  #   A Boolean indicating whether to require a direct read or if a cached
  #   copy is acceptable.
  #
  # Returns a promise that resovles to a String.
  read: (flushCache) ->


  # Public: Creates a new file.
  #
  # path - A {String} containing the absolute path to the file
  # symlink - A {Boolean} indicating if the path is a symlink (default: false).
  constructor: (@path, @symlink=false) ->
    throw new Error("#{@path} is a directory") if fs.isDirectorySync(@path)

