Fill in more documentation blanks in dart:io.

sdk/lib/io/stdio.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;
 
 const int _STDIO_HANDLE_TYPE_TERMINAL = 0;
 const int _STDIO_HANDLE_TYPE_PIPE = 1;
 const int _STDIO_HANDLE_TYPE_FILE = 2;
 const int _STDIO_HANDLE_TYPE_SOCKET = 3;
@@ skipping 153 matching lines @@
   void add(List<int> data) => _sink.add(data);
   void addError(error, [StackTrace stackTrace]) =>
       _sink.addError(error, stackTrace);
   void writeCharCode(int charCode) => _sink.writeCharCode(charCode);
   Future addStream(Stream<List<int>> stream) => _sink.addStream(stream);
   Future flush() => _sink.flush();
   Future close() => _sink.close();
   Future get done => _sink.done;
 }
 
+/// The type of object a standard IO stream is attached to.
 class StdioType {
   static const StdioType TERMINAL = const StdioType._("terminal");
   static const StdioType PIPE = const StdioType._("pipe");
   static const StdioType FILE = const StdioType._("file");
   static const StdioType OTHER = const StdioType._("other");
   final String name;
   const StdioType._(String this.name);
   String toString() => "StdioType: $name";
 }
 
 
 Stdin _stdin;
 IOSink _stdout;
 IOSink _stderr;
 
 
+/// The standard input stream of data read by this program.
 Stdin get stdin {
   if (_stdin == null) {
     _stdin = _StdIOUtils._getStdioInputStream();
   }
   return _stdin;
 }
 
 
+/// The standard output stream of data written by this program.
 IOSink get stdout {
   if (_stdout == null) {
     _stdout = _StdIOUtils._getStdioOutputStream(1);
   }
   return _stdout;
 }
 
 
+/// The standard output stream of errors written by this program.
 IOSink get stderr {
   if (_stderr == null) {
     _stderr = _StdIOUtils._getStdioOutputStream(2);
   }
   return _stderr;
 }
 
 
+/// For a stream, returns whether it is attached to a file, pipe, terminal, or
+/// something else.
 StdioType stdioType(object) {
   if (object is _StdStream) {
     object = object._stream;
   } else if (object is _StdSink) {
     object = object._sink;
   }
   if (object is _FileStream) {
     return StdioType.FILE;
   }
   if (object is Socket) {
@@ skipping 14 matching lines @@
   }
   return StdioType.OTHER;
 }
 
 
 class _StdIOUtils {
   external static IOSink _getStdioOutputStream(int fd);
   external static Stdin _getStdioInputStream();
   external static int _socketType(nativeSocket);
 }