Add documentation to the FileSystemException class

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 543 matching lines @@
    */
   String toString();
 
   /**
    * Gets the path of the file underlying this RandomAccessFile.
    */
   String get path;
 }
 
 
+/**
+ * Exception thrown when a file operation fails.
+ */
 class FileSystemException implements IOException {
+  /**
+   * Message describing the error. This does not include any detailed
+   * information form the underlying OS error. Check [osError] for
+   * that information.
+   */
   final String message;
+
+  /**
+   * The file system path on which the error occurred. Can be `null`
+   * if the exception does not relate directly to a file system path.
+   */
   final String path;
+
+  /**
+   * The underlying OS error. Can be `null` if the exception is not
+   * raised due to an OS error.
+   */
   final OSError osError;
+
+  /**
+   * Creates a new FileSystemException with an optional error message
+   * [message], optional file system path [path] and optional OS error
+   * [osError].
+   */
   const FileSystemException([this.message = "", this.path = "", this.osError]);
 
   String toString() {
     StringBuffer sb = new StringBuffer();
     sb.write("FileSystemException");
     if (!message.isEmpty) {
       sb.write(": $message");
       if (path != null) {
-        sb.write(", path = $path");
+        sb.write(", path = '$path'");
       }
       if (osError != null) {
         sb.write(" ($osError)");
       }
     } else if (osError != null) {
-      sb.write(": osError");
+      sb.write(": $osError");
       if (path != null) {
-        sb.write(", path = $path");
+        sb.write(", path = '$path'");
       }
+    } else if (path != null) {
+      sb.write(": $path");
     }
     return sb.toString();
   }
 }