dart:io | Add 'recursive' flag to File.create and Link.create.

sdk/lib/io/file.dart

 // Copyright (c) 2013, 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;
 
 /**
  * FileMode describes the modes in which a file can be opened.
  */
 class FileMode {
@@ skipping 26 matching lines @@
 abstract class File implements FileSystemEntity {
   /**
    * Create a File object.
    */
   factory File(String path) => new _File(path);
 
   /**
    * Create the file. Returns a [:Future<File>:] that completes with
    * the file when it has been created.
    *
+   * If [recursive] is false, the default, the file is created only if
+   * all directories in the path exist. If [recursive] is true, all
+   * non-existing path components are created.
+   *
    * Existing files are left untouched by [create]. Calling [create] on an
    * existing file might fail if there are restrictive permissions on
    * the file.
+   *
+   * Completes the future with a [FileSystemException] if the operation fails.
    */
-  Future<File> create();
+  Future<File> create({bool recursive: false});
 
   /**
    * Synchronously create the file. Existing files are left untouched
    * by [createSync]. Calling [createSync] on an existing file might fail
    * if there are restrictive permissions on the file.
    *
+   * If [recursive] is false, the default, the file is created
+   * only if all directories in the path exist.
+   * If [recursive] is true, all non-existing path components are created.
+   *
    * Throws a [FileSystemException] if the operation fails.
    */
-  void createSync();
+  void createSync({bool recursive: false});
 
   /**
    * Renames this file. Returns a `Future<File>` that completes
    * with a [File] instance for the renamed file.
    *
    * If [newPath] identifies an existing file, that file is
    * replaced. If [newPath] identifies an existing directory, the
    * operation fails and the future completes with an exception.
    */
   Future<File> rename(String newPath);
@@ skipping 444 matching lines @@
       }
     } else if (osError != null) {
       sb.write(": osError");
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
 }