Move delete/deleteSync up to FileSystemEntity, with a shared documentation.

sdk/lib/io/directory.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * [Directory] objects are used for working with directories.
  */
 abstract class Directory implements FileSystemEntity {
@@ skipping 71 matching lines @@
   /**
    * Synchronously creates a temporary directory with a name based on the
    * current path. The path is used as a template, and additional
    * characters are appended to it to make a unique temporary directory name.
    * If the path is the empty string, a default system temp directory and name
    * are used for the template. Returns the newly created temporary directory.
    */
   Directory createTempSync();
 
   /**
-   * Deletes this directory.
-   *
-   * If [recursive] is false, the directory must be empty.  Only directories
-   * and links to directories will be deleted.
-   *
-   * If [recursive] is true, this directory and all sub-directories
-   * and files in the directories are deleted. Links are not followed
-   * when deleting recursively. Only the link is deleted, not its target.
-   *
-   * If [recursive] is true, the target is deleted even if it is a file, or
-   * a link to a file, not only if it is a directory.  This behavior allows
-   * [delete] to be used to unconditionally delete any file system object.
-   *
-   * Returns a [:Future<Directory>:] that completes with this
-   * directory when the deletion is done. If the directory cannot be
-   * deleted, the future completes with an exception.
-   */
-  Future<Directory> delete({recursive: false});
-
-  /**
-   * Synchronously deletes this directory.
-   *
-   * If [recursive] is false, the directory must be empty.
-   *
-   * If [recursive] is true, this directory and all sub-directories
-   * and files in the directories are deleted. Links are not followed
-   * when deleting recursively. Only the link is deleted, not its target.
-   *
-   * If [recursive] is true, the target is deleted even if it is a file, or
-   * a link to a file, not only if it is a directory.  This behavior allows
-   * [delete] to be used to unconditionally delete any file system object.
-   *
-   * Throws an exception if the directory cannot be deleted.
-   */
-  void deleteSync({recursive: false});
-
-  /**
    * Renames this directory. Returns a [:Future<Directory>:] that completes
    * with a [Directory] instance for the renamed directory.
    *
    * If newPath identifies an existing directory, that directory is
    * replaced. If newPath identifies an existing file, the operation
    * fails and the future completes with an exception.
    */
   Future<Directory> rename(String newPath);
 
   /**
@@ skipping 84 matching lines @@
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }