Updated docs for FileMode.

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 {
+  /// The [FileMode] for opening a file only for reading.
   static const READ = const FileMode._internal(0);
+  /// The [FileMode] for opening a file for reading and writing. The file will
+  /// be overwritten. If the file does not exist, it will be created.
   static const WRITE = const FileMode._internal(1);
+  /// The [FileMode] for opening a file for reading a file and writing to the
+  /// end of it. If the file does not exist, it will be created.
   static const APPEND = const FileMode._internal(2);
   const FileMode._internal(int this._mode);
   final int _mode;
 }
 
+/// The [FileMode] for opening a file only for reading.
 const READ = FileMode.READ;
+/// The [FileMode] for opening a file for reading and writing. The file will be
+/// overwritten. If the file does not exist, it will be created.
 const WRITE = FileMode.WRITE;
+/// The [FileMode] for opening a file for reading a file and writing to the end
+/// of it. If the file does not exist, it will be created.
 const APPEND = FileMode.APPEND;
 
 /**
  * A reference to a file on the file system.
  *
  * If [path] is a symbolic link, rather than a file, then
  * the methods of [File] operate on the ultimate target of the
  * link, except for File.delete and File.deleteSync, which operate on
  * the link.
  *
@@ skipping 521 matching lines @@
       }
     } else if (osError != null) {
       sb.write(": osError");
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
 }