dart:io | Rename File.name to File.path.

sdk/lib/io/file.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;
 
 /**
  * FileMode describes the modes in which a file can be opened.
  */
 class FileMode {
@@ skipping 12 matching lines @@
  *
  *  * Use streaming: read the contents of the file from the [Stream]
  *    this.[openRead]() and write to the file by writing to the [IOSink]
  *    this.[openWrite]().
  *  * Open the file for random access operations using [open].
  */
 abstract class File extends FileSystemEntity {
   /**
    * Create a File object.
    */
-  factory File(String name) => new _File(name);
+  factory File(String path) => new _File(path);
 
   /**
    * Create a File object from a Path object.
    */
   factory File.fromPath(Path path) => new _File.fromPath(path);
 
   /**
    * Check if the file exists. Returns a
    * [:Future<bool>:] that completes when the answer is known.
    */
@@ skipping 92 matching lines @@
    * Synchronously open the file for random access operations. The
    * result is a [RandomAccessFile] on which random access operations
    * can be performed. Opened [RandomAccessFile]s must be closed using
    * the [RandomAccessFile.close] method.
    *
    * See [open] for information on the [mode] argument.
    */
   RandomAccessFile openSync([FileMode mode = FileMode.READ]);
 
   /**
-   * Get the canonical full path corresponding to the file name.
+   * Get the canonical full path corresponding to the file path.
    * Returns a [:Future<String>:] that completes with the path.
    */
   Future<String> fullPath();
 
   /**
-   * Synchronously get the canonical full path corresponding to the file name.
+   * Synchronously get the canonical full path corresponding to the file path.
    */
   String fullPathSync();
 
   /**
    * Create a new independent [Stream](../dart_async/Stream.html) for the
    * contents of this file.
    *
    * In order to make sure that system resources are freed, the stream
    * must be read to completion or the subscription on the stream must
    * be cancelled.
@@ skipping 104 matching lines @@
    * By default [writeAsStringSync] creates the file for writing and
    * truncates the file if it already exists. In order to append the bytes
    * to an existing file, pass [FileMode.APPEND] as the optional mode
    * parameter.
    */
   void writeAsStringSync(String contents,
                          {FileMode mode: FileMode.WRITE,
                           Encoding encoding: Encoding.UTF_8});
 
   /**
-   * Get the name of the file.
+   * Get the path of the file.
    */
-  String get name;
+  String get path;
 }
 
 
 /**
  * [RandomAccessFile] provides random access to the data in a
  * file. [RandomAccessFile] objects are obtained by calling the
  * [:open:] method on a [File] object.
  */
 abstract class RandomAccessFile {
   /**
@@ skipping 147 matching lines @@
    * Synchronously flushes the contents of the file to disk.
    */
   void flushSync();
 
   /**
    * Returns a human-readable string for this RandomAccessFile instance.
    */
   String toString();
 
   /**
-   * Gets the name of the file underlying this RandomAccessFile.
+   * Gets the path of the file underlying this RandomAccessFile.
    */
-  String get name;
+  String get path;
 }
 
 
 class FileIOException implements Exception {
   const FileIOException([String this.message = "",
                          OSError this.osError = null]);
   String toString() {
     StringBuffer sb = new StringBuffer();
     sb.add("FileIOException");
     if (!message.isEmpty) {
       sb.add(": $message");
       if (osError != null) {
         sb.add(" ($osError)");
       }
     } else if (osError != null) {
       sb.add(": osError");
     }
     return sb.toString();
   }
   final String message;
   final OSError osError;
 }