add back dart:mirrors content, remove dart:isolate, misc. tweaks/updates

ch00.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
 <preface id="preface">
   <?dbhtml stop-chunking?>
 
   <title>Preface</title>
 
   <para>You don’t need to be an expert web developer to build web apps. With
   Dart, you can be productive as you build high-performance apps for the
@@ skipping 186 matching lines @@
 
   <sect1 id="preface-updates">
     <title>Content Updates</title>
 
     <para>This section gives details about how the book has changed since its
     first and second printings.</para>
 
     <sect2 id="preface-updates-v3">
       <title>Changes After the Second Printing</title>
 
-      <para>We’ve updated the content to reflect the following M4
+      <para>We've changed the text and examples to reflect these language
       changes:</para>
 
       <itemizedlist>
         <listitem>
-          <para>File’s <literal>openWrite()</literal> method now has no
-          required parameters but two optional named parameters. The
-          <literal>mode</literal> parameter has a default value of
-          <literal>FileMode.WRITE</literal>.</para>
+          <para>Instance variables can no longer be <literal>const</literal>.
+          Use <literal>static const</literal> variables instead.</para>

[sethladd, 2013/12/04 19:06:01]

you said instance variables, but you mention static here.

         </listitem>
 
         <listitem>
-          <para>File’s <literal>readAsString()</literal> and
-          <literal>readAsLines()</literal> methods no longer require a
-          parameter. Instead, they have an optional named parameter
-          (<literal>encoding</literal>), with a default value of
-          <literal>Encoding.UTF_8</literal>.</para>
+          <para>The <literal>?</literal> operator for testing whether an
+          optional parameter has been set is no longer in the language.</para>
         </listitem>
 
         <listitem>
-          <para>IOSink’s methods for writing data have changed. To write
-          string data, instead of <literal>addString()</literal> use
-          <literal>write()</literal>. The method for writing binary data was
-          temporarily renamed to <literal>writeBytes()</literal>, but is now
-          back to <literal>add()</literal>.</para>
+          <para>Keys in map literals no longer need to be strings.</para>
         </listitem>
 
         <listitem>
+          <para>Dart now has Symbols and symbol literals
+          (<literal>#<replaceable>identifier</replaceable></literal>): <xref
+          linkend="ch02-symbols" />.</para>
+        </listitem>
+
+        <listitem>
+          <para>Function equality testing is easier: <xref
+          linkend="ch02-function-equality" />.</para>
+        </listitem>
+
+        <listitem>
+          <para>Bitwise operators have higher precedence than they used
+          to.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>We've also updated the content to reflect API changes. In
+      dart:core:</para>
+
+      <itemizedlist>
+        <listitem>
           <para>Set’s <literal>isSubsetOf()</literal> method is gone. Instead,
           use the Set <literal>containsAll()</literal> method. You can convert
           any Iterable to a Set using <literal>toSet()</literal>.</para>
         </listitem>
 
         <listitem>
           <para>The Collection class is gone, so we’ve changed the way we
           talked about sets, lists, and maps in <xref
           linkend="ch03-collections" />, and we talk more about
           Iterable.</para>
         </listitem>
 
         <listitem>
-          <para>The AsyncError class has been removed.</para>
-        </listitem>
-      </itemizedlist>
-
-      <para>M5 introduced additional changes:</para>
-
-      <itemizedlist>
-        <listitem>
-          <para>The dart_analyzer tool has been replaced by
-          dartanalyzer.</para>
-        </listitem>
-
-        <listitem>
-          <para>Instance variables can no longer be <literal>const</literal>.
-          Use <literal>static const</literal> variables instead.</para>
-        </listitem>
-
-        <listitem>
-          <para>The <literal>?</literal> operator for testing whether an
-          optional parameter has been set is no longer in the language.</para>
-        </listitem>
-
-        <listitem>
-          <para>The dart:crypto library has moved out of the SDK (to <ulink
-          url="http://pub.dartlang.org/packages/crypto">http://pub.dartlang.org/packages/crypto</ulink>).</para>
-        </listitem>
-
-        <listitem>
-          <para>The dart:uri library is gone, its functionality folded into a
-          new Uri class in dart:core. The top-level functions
+          <para>The functionality in the former dart:uri library is now in the
+          Uri class in dart:core. The top-level functions
           <literal>encodeUri()</literal>,
           <literal>encodeUriComponent()</literal>,
           <literal>decodeUri()</literal>, and
           <literal>decodeUriComponent()</literal> are now static methods in
           Uri named (respectively) <literal>encodeFull()</literal>,
           <literal>encodeComponent()</literal>,
           <literal>decodeFull()</literal>, and
           <literal>decodeComponent()</literal>. To create a Uri from a string,
           you now use the static <literal>parse()</literal> method. Uri now
           has a single constructor, which takes the arguments that the
           <literal>Uri.fromComponents()</literal> constructor used to take.
           Finally, the <literal>domain</literal> field is now named
           <literal>host</literal>.</para>
         </listitem>
-      </itemizedlist>
-
-      <itemizedlist>
-        <listitem>
-          <para>The dartdoc <literal>--pkg</literal> command-line option is
-          now <literal>--package-root</literal>.</para>
-        </listitem>
-      </itemizedlist>
-
-      <para>M6, M7, and M8 introduced additional changes:</para>
-
-      <itemizedlist>
-        <listitem>
-          <para>Keys in map literals no longer need to be strings.</para>
-        </listitem>
-
-        <listitem>
-          <para>Dart now has Symbols and symbol literals
-          (<literal>#<replaceable>identifier</replaceable></literal>): <xref
-          linkend="ch02-symbols" />.</para>
-        </listitem>
-
-        <listitem>
-          <para>Function equality testing is easier: <xref
-          linkend="ch02-function-equality" />.</para>
-        </listitem>
-
-        <listitem>
-          <para>Bitwise operators have higher precedence than they used
-          to.</para>
-        </listitem>
 
         <listitem>
           <para>The @deprecated, @override, and @proxy annotations moved from
           the meta package to dart:core.</para>
         </listitem>
+      </itemizedlist>
+
+      <para>In dart:io:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>File’s <literal>openWrite()</literal> method now has no
+          required parameters but two optional named parameters. The
+          <literal>mode</literal> parameter has a default value of
+          <literal>FileMode.WRITE</literal>.</para>
+        </listitem>
 
         <listitem>
+          <para>File’s <literal>readAsString()</literal> and
+          <literal>readAsLines()</literal> methods no longer require a
+          parameter. Instead, they have an optional named parameter
+          (<literal>encoding</literal>), with a default value of
+          <literal>Encoding.UTF_8</literal>.</para>
+        </listitem>
+
+        <listitem>
+          <para>IOSink’s methods for writing data have changed. To write
+          string data, instead of <literal>addString()</literal> use
+          <literal>write()</literal>. The method for writing binary data was
+          temporarily renamed to <literal>writeBytes()</literal>, but reverted
+          back to <literal>add()</literal>.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>A new dart:convert library replaces dart:json and dart:uri:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Instead of a StringDecoder, use
+          <literal>UTF8.decoder</literal> to convert UTF-8 characters into a
+          Dart string.</para>
+        </listitem>
+
+        <listitem>
+          <para>Instead of a LineTransformer, use a LineSplitter object to
+          split a stream of strings into a stream of individual lines.</para>
+        </listitem>
+
+        <listitem>
+          <para>Where you used to use dart:json's top-level
+          <literal>parse()</literal> and <literal>stringify()</literal>
+          functions, use <literal>JSON.decode()</literal> and
+          <literal>JSON.encode()</literal>, respectively.</para>
+        </listitem>
+
+        <listitem>
+          <para>Where you used to use dart:uri's top-level
+          <literal>decodeUri()</literal> and <literal>encodeUri()</literal>
+          functions, use <literal>UTF8.decode()</literal> and
+          <literal>UTF8.encode()</literal>, respectively.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>Other API changes include:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>In dart:html, the <literal>query()</literal> and
+          <literal>queryAll()</literal> methods changed to
+          <literal>querySelector()</literal> and
+          <literal>querySelectorAll()</literal>, respectively.</para>
+        </listitem>
+
+        <listitem>
+          <para>The dart:crypto library moved out of the SDK (to <ulink
+          url="http://pub.dartlang.org/packages/crypto">http://pub.dartlang.org/packages/crypto</ulink>).</para>
+        </listitem>
+
+        <listitem>
+          <para>The AsyncError class was removed (from dart:async).</para>
+        </listitem>
+
+        <listitem>
+          <para>The dart:isolate library was refactored to have only core
+          primitives. We removed its coverage from the book but expect higher
+          level APIs to come along that make using isolates easier.</para>
+        </listitem>
+
+        <listitem>
           <para>The main() function now takes an optional argument
           (List&lt;String&gt;).</para>
         </listitem>
       </itemizedlist>
 
+      <para>The sections that talk about tools have changed, too:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>The dart_analyzer tool has been replaced by
+          dartanalyzer.</para>
+        </listitem>
+
+        <listitem>
+          <para>Command-line arguments for many tools have changed. For
+          example, the dartdoc <literal>--pkg</literal> command-line option
+          changed to <literal>--package-root</literal>.</para>
+        </listitem>
+
+        <listitem>
+          <para>The pub tool now has build and serve commands, which work with
+          transformers to convert your source files into their final
+          format.</para>
+        </listitem>
+
+        <listitem>
+          <para>We fleshed out the dart2js docs.</para>
+        </listitem>
+      </itemizedlist>
+
       <para>We also added new coverage of previously undocumented features and
-      tweaked existing coverage:</para>
+      tweaked existing coverage. In the language tour:</para>
 
       <itemizedlist>
         <listitem>
           <para>Added <xref linkend="ch02-mixins" />.</para>
         </listitem>
 
         <listitem>
-          <para>Added <xref linkend="ch03-mirrors" />.</para>
-        </listitem>
-
-        <listitem>
           <para>In <xref linkend="ch02-keywords" />, marked which keywords are
           built-in identifiers and discussed how they differ from reserved
           words.</para>
         </listitem>
 
         <listitem>
           <para>Added coverage of the + operator for strings.</para>
         </listitem>
 
         <listitem>
-          <para>Fleshed out dart2js docs.</para>
-        </listitem>
-
-        <listitem>
-          <para>Removed the incorrect <literal>new</literal> from the example
-          of using Future.wait().</para>
-        </listitem>
-
-        <listitem>
           <para>Discussed using expressions (such as function calls) as
           arguments to a non-default constructor.</para>
         </listitem>
 
         <listitem>
           <para>Added examples of using the @override and @proxy
           annotations.</para>
         </listitem>
 
         <listitem>
           <para>Changed the doc comment example to match the latest
           guidelines, and pointed to <ulink
           url="https://www.dartlang.org/articles/doc-comment-guidelines/">Guidelines
           for Dart Doc Comments.</ulink></para>
         </listitem>
       </itemizedlist>
+
+      <para>In the library tour:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Added <xref linkend="ch03-mirrors" />.</para>
+        </listitem>
+
+        <listitem>
+          <para>Added examples of parsing non-decimal numbers.</para>
+        </listitem>
+
+        <listitem>
+          <para>Removed the incorrect <literal>new</literal> from the example
+          of using Future.wait().</para>
+        </listitem>
+
+        <listitem>
+          <para>Removed coverage of Completer, which is no longer
+          recommended.</para>
+        </listitem>
+
+        <listitem>
+          <para>Added <xref linkend="ch03-streams" />.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>Throughout the book, we updated links to related topics.</para>
     </sect2>
 
     <sect2 id="preface-updates-v2">
       <title>Changes in the Second Printing: March 29, 2013</title>
 
       <para>We’ve updated the content to reflect the following changes since
       the first printing:</para>
 
       <itemizedlist>
         <listitem>
@@ skipping 319 matching lines @@
     work and helped us make some last-minute fixes that improved the final
     result. We’d also like to thank the good people who manage the author
     workflow and make working on an O’Reilly book such a pleasure. We
     personally worked with Sarah Schneider, Jessica Hosman, and Rachel
     James.</para>
 
     <para>Finally, we thank Lars Bak and Kasper Lund for writing the foreword,
     and most of all for creating Dart.</para>
   </sect1>
 </preface>