Remove Encoding.BINARY

sdk/lib/io/process.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;
 
 // TODO(ager): The only reason for this class is that we
 // cannot patch a top-level at this point.
 class _ProcessUtils {
   external static void _exit(int status);
@@ skipping 97 matching lines @@
    * platforms, which may have impact when using relative paths for the
    * executable and the arguments.
    *
    * Use [environment] to set the environment variables for the process. If not
    * set the environment of the parent process is inherited. Currently, only
    * US-ASCII environment variables are supported and errors are likely to occur
    * if an environment variable with code-points outside the US-ASCII range is
    * passed in.
    *
    * If [runInShell] is true, the process will be spawned through a system
-   * shell. On Linux and Mac OS, [:/bin/sh:] is used, while
-   * [:%WINDIR%\system32\cmd.exe:] is used on Windows.
+   * shell. On Linux and Mac OS, `/bin/sh` is used, while
+   * `%WINDIR%\system32\cmd.exe` is used on Windows.
    *
-   * The encoding used for text on stdout and stderr can be set by changing
-   * [stdoutEncoding] and [stderrEncoding]. The default encoding is SYSTEM.
+   * The encoding used for decoding `stdout` and `stderr` into text is
+   * controlled through [stdoutEncoding] and [stderrEncoding]. The
+   * default encoding is `Encoding.SYSTEM`. If `null` is used no
+   * decoding will happen and the [ProcessResult] will hold binary
+   * data.
    *
-   * Returns a [:Future<ProcessResult>:] that completes with the
+   * Returns a `Future<ProcessResult>` that completes with the
    * result of running the process, i.e., exit code, standard out and
    * standard in.
    */
   external static Future<ProcessResult> run(
       String executable,
       List<String> arguments,
       {String workingDirectory,
        Map<String, String> environment,
        bool runInShell: false,
        Encoding stdoutEncoding: Encoding.SYSTEM,
@@ skipping 60 matching lines @@
  */
 abstract class ProcessResult {
   /**
    * Exit code for the process.
    */
   int get exitCode;
 
   /**
    * Standard output from the process. The value used for the
    * `stdoutEncoding` argument to `Process.run` determins the type. If
-   * `Encoding.BINARY` was used this value is of type `List<int>
-   * otherwise it is of type `String`.
+   * `null` was used this value is of type `List<int> otherwise it is
+   * of type `String`.
    */
   get stdout;
 
   /**
    * Standard error from the process. The value used for the
    * `stderrEncoding` argument to `Process.run` determins the type. If
-   * `Encoding.BINARY` was used this value is of type `List<int>
+   * `null` was used this value is of type `List<int>
    * otherwise it is of type `String`.
    */
   get stderr;
 
   /**
    * Process id from the process.
    */
   int get pid;
 }
 
@@ skipping 61 matching lines @@
   /**
    * Contains the system message for the process exception if any.
    */
   final String message;
 
   /**
    * Contains the OS error code for the process exception if any.
    */
   final int errorCode;
 }