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

ch03.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
 <chapter id="ch03">
   <?dbhtml stop-chunking?>
 
   <title>A Tour of the Dart Libraries</title>
 
   <para>This chapter shows you how to use the major features in Dart’s
   libraries. It’s just an overview, and by no means comprehensive. Whenever
@@ skipping 1221 matching lines @@
 assert(double.parse(sinOf30degrees.toStringAsPrecision(2)) == 0.5);</screen>
 
       <note>
         <para>These functions use radians, not degrees!</para>
       </note>
     </sect2>
 
     <sect2 id="ch03-maximum-and-minimum">
       <title>Maximum and Minimum</title>
 
       <para>The Math library provides optimized <literal>max()</literal> and

[Emily Fortuna, 2013/12/05 21:55:11]

what do you mean by "optimized" methods here?

[Kathy Walrath, 2013/12/13 00:48:20]

Done.

       <literal>min()</literal> methods:</para>
 
       <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03/math-tests.dart
 </remark>assert(math.max(1, 1000) == 1000);
 assert(math.min(1, -1000) == -1000);</screen>
     </sect2>
 
     <sect2 id="ch03-math-constants">
       <title>Math Constants</title>
@@ skipping 55 matching lines @@
     <emphasis>Document Object Model</emphasis>, which describes the hierarchy
     of an HTML page.</para>
 
     <para>Other common uses of dart:html are manipulating styles
     (<emphasis>CSS</emphasis>), getting data using HTTP requests, and
     exchanging data using <link linkend="ch03-websockets">WebSockets</link>.
     HTML5 (and dart:html) has many additional APIs that this section doesn’t
     cover. Only web apps can use dart:html, not command-line apps.</para>
 
     <note>
       <para>For scalable, higher level approaches to web app UIs, see <ulink

[Emily Fortuna, 2013/12/05 21:55:11]

might consider removing "scalable" ... that seems to suggest that the dart:html
library is not really a viable option to use on its own (yes, obviously Polymer
helps make it better, but we don't want to suggest that dart:html is not good to
work with directly)

[Kathy Walrath, 2013/12/13 00:48:20]

Done.

       url="http://www.dartlang.org/polymer-dart/">Polymer.dart</ulink> and
       <ulink
       url="http://pub.dartlang.org/packages/angular">AngularDart</ulink>.</para>
     </note>
 
     <para>To use the HTML library in your web app, import dart:html:</para>
 
     <programlisting format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>import 'dart:html';</programlisting>
 
     <note>
       <para>Parts of the dart:html library are experimental, as noted in the
       API documentation.</para>
     </note>
 
     <sect2 id="ch03-manipulating-the-dom">
       <title>Manipulating the DOM</title>
 
       <para>To use the DOM, you need to know about
       <emphasis>windows</emphasis>, <emphasis>documents</emphasis>,
       <emphasis>elements</emphasis>, and <emphasis>nodes</emphasis>.</para>
 
       <para>A <ulink
       url="http://api.dartlang.org/html/Window.html">Window</ulink> object
       represents the actual window of the web browser. Each Window has a
       <literal moreinfo="none">document</literal> property (a Document

[Emily Fortuna, 2013/12/05 21:55:11]

Consider just saying "Document object" instead of "property (a Document
object)". Users can determine it's a property by looking at the documentation,
and it's assumed if the Window has it, you can access it in some way.

[Kathy Walrath, 2013/12/13 00:48:20]

Done.

       object), which points to the document currently loaded. The Window
       object also has accessors to various APIs such as IndexedDB (for storing
       data), <literal>requestAnimationFrame()</literal> (for animations), and

[Emily Fortuna, 2013/12/05 21:55:11]

actually the current Dart idiom is to use "animationFrame"
https://api.dartlang.org/docs/channels/be/latest/dart_html/Window.html#animat...
which returns a Future, when possible.

[Kathy Walrath, 2013/12/13 00:48:20]

I switched to not use the () and code font, since I wanted to refer to the API
in general, not to our implementation of the API.

       more. In tabbed browsers, each tab has its own Window object.</para>
 
       <para>With the <ulink
       url="http://api.dartlang.org/html/Document.html">Document</ulink>
       object, you can create and manipulate <ulink
       url="http://api.dartlang.org/html/Element.html">Elements</ulink> within
       the document. Note that the document itself is an element and can be
       manipulated.</para>
 
       <para>The DOM models a tree of <ulink
@@ skipping 70 matching lines @@
         <para>Often you need to set properties on multiple elements. For
         example, the following code sets the <literal
         moreinfo="none">hidden</literal> property of all elements that have a
         class of “mac”, “win”, or “linux”. Setting the <literal
         moreinfo="none">hidden</literal> property to true has the same effect
         as adding <literal moreinfo="none">display:none</literal> to <phrase
         role="keep-together">the CSS</phrase>.</para>
 
         <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>&lt;!-- In HTML: --&gt;

[Emily Fortuna, 2013/12/05 21:55:11]

consider formatting the html and the dart code into separate boxes since you
can't paste the whole thing into a single file as written.

 <p>
   <span class="os linux">Words for Linux</span>
   <span class="os mac">Words for Mac</span>
   <span class="os win">Words for Windows</span>
 </p>
 <remark>
 </remark>// In Dart:
 final osList = ['mac', 'win', 'linux'];
 
 var userOs = 'linux'; // In real code you'd programmatically determine this.
@@ skipping 31 matching lines @@
 </remark>var elem = new ParagraphElement();
 elem.text = 'Creating is easy!';</screen>
 
         <para>You can also create an element by parsing HTML text. Any child
         elements are also parsed and created.</para>
 
         <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>var elem2 = new Element.html('&lt;p&gt;Creating &lt;em&gt;is&lt;/em&gt; easy!&lt;/p&gt;');</screen>
 
         <para>Note that elem2 is a ParagraphElement in the above

[Emily Fortuna, 2013/12/05 21:55:11]

"Note that elem2 is also a ParagraphElement object in..."

[Emily Fortuna, 2013/12/05 21:55:11]

"Note that elem2 is also a ParagraphElement object in..."

         example.</para>
 
         <para>Attach the newly created element to the document by assigning a
         parent to the element. You can add an element to any existing
         element’s children. In the following example, <literal
         moreinfo="none">body</literal> is an element, and its child elements
         are accessible (as a List&lt;Element&gt;) from the <literal
         moreinfo="none">children</literal> property.</para>
 
         <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>document.body.children.add(elem2);</screen>
       </sect3>
 
       <sect3 id="ch03-adding-replacing-and-removing-nodes">
         <title>Adding, replacing, and removing nodes</title>
 
         <para>Recall that elements are just a kind of node. You can find all
         the children of a node using the <literal
         moreinfo="none">nodes</literal> property of Node, which returns a
         List&lt;Node&gt;. Once you have this list, you can use the usual List

[Emily Fortuna, 2013/12/05 21:55:11]

maybe add "as opposed to 'children' which just returns the child elements."

[Kathy Walrath, 2013/12/13 00:48:20]

Done.

         methods and operators to manipulate the children of the node.</para>
 
         <para>To add a node as the last child of its parent, use the List
         <literal>add()</literal> method:</para>
 
         <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>// Find the parent by ID, and add elem as its last child.
 querySelector('#inputs').nodes.add(elem);</screen>
 
@@ skipping 41 matching lines @@
 </remark>var message = new DivElement();
 message.id = 'message2';
 message.text = 'Please subscribe to the Dart mailing list.';</screen>
 
         <para>You can reduce the redundant text in this example by using
         method cascades:</para>
 
         <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>var message = new DivElement()
     ..id = 'message2'

[Emily Fortuna, 2013/12/05 21:55:11]

stylistic note: at google, when the line is a method cascade, we only indent +2
spaces from the previous line rather than the 4

[Kathy Walrath, 2013/12/13 00:48:20]

I had to look this one up. According to
https://code.google.com/p/dart/issues/detail?id=8175, the style guide has been
amended to specify 4 spaces for cascades:

https://www.dartlang.org/articles/style-guide/#do-use-four-spaces-for-method-...

     ..text = 'Please subscribe to the Dart mailing list.';</screen>
 
         <para>While using IDs and classes to associate an element with a set
         of styles is best practice, sometimes you want to attach a specific
         style directly to the element:</para>
 
         <screen format="linespecific"><remark>lang-dart
 </remark><remark>ch03_html/ch03_html.dart
 </remark>message.style
     ..fontWeight = 'bold'
@@ skipping 165 matching lines @@
     print('License: $license');
   } catch(e) {
     print('$xmlUri doesn\'t have correct XML formatting.');
   }
 }
 ...</screen>
 
         <para>You can also use the full API to handle more interesting cases.
         For example, you can set arbitrary headers.</para>
 
         <para>The general flow for using the full API of HttpRequest is as

[Emily Fortuna, 2013/12/05 21:55:11]

maybe just condense this list into a sentence. Given its position on the page it
stands out a lot, and I'm not sure it's *that* important relative to explaining
the main usage with FUtures. ALso you see it in the code example below

         follows:</para>
 
         <orderedlist continuation="restarts" inheritnum="ignore"
                      numeration="arabic">
           <listitem>
             <para>Create the HttpRequest object.</para>
           </listitem>
 
           <listitem>
             <para>Open the URL with either <literal
@@ skipping 180 matching lines @@
       url="http://www.dartlang.org/samples/">Dart Code Samples.</ulink> Dart
       has additional libraries for more specialized web APIs, such as <ulink
       url="http://api.dartlang.org/dart_web_audio.html">web audio,</ulink>
       <ulink
       url="http://api.dartlang.org/dart_indexed_db.html">IndexedDB</ulink>,
       and <ulink
       url="http://api.dartlang.org/dart_web_gl.html">WebGL</ulink>.</para>
     </sect2>
   </sect1>
 
-  <sect1 id="ch03-dartisolate---concurrency-with-isolates">
-    <title>dart:isolate - Concurrency with Isolates</title>
-
-    <para>Dart has no shared-memory threads. Instead, all Dart code runs in
-    isolates, which communicate via message passing. Messages are copied
-    before they are received, ensuring that no two isolates can manipulate the
-    same object instance. Because state is managed by individual isolates, no
-    locks or mutexes are needed, greatly simplifying concurrent
-    programming.</para>
-
-    <note>
-      <para>The isolate API changed recently. We'll update this section to
-      reflect the new API. <remark> {PENDING: update!!!} </remark></para>
-    </note>
-
-    <remark><p /></remark>
-
-    <sect2 id="ch03-isolate-concepts">
-      <title>Isolate Concepts</title>
-
-      <para>To use isolates, you should understand the following
-      concepts:</para>
-
-      <itemizedlist>
-        <listitem>
-          <para>No two isolates ever share the same thread at the same time.
-          Within an isolate, callbacks execute one at a time, making the code
-          more predictable.</para>
-        </listitem>
-
-        <listitem>
-          <para>All values in memory, including globals, are available only to
-          their isolate. No isolate can see or manipulate values owned by
-          another isolate.</para>
-        </listitem>
-
-        <listitem>
-          <para>The only way isolates can communicate with each other is by
-          passing messages.</para>
-        </listitem>
-
-        <listitem>
-          <para>Isolates send messages using SendPorts, and receive them using
-          ReceivePorts.</para>
-        </listitem>
-
-        <listitem>
-          <para>The content of a message can be any of the following:</para>
-
-          <itemizedlist>
-            <listitem>
-              <para>A primitive value (null, num, bool, double, String)</para>
-            </listitem>
-
-            <listitem>
-              <para>An instance of SendPort</para>
-            </listitem>
-
-            <listitem>
-              <para>A list or map whose elements are any of the above,
-              including other lists and maps</para>
-            </listitem>
-          </itemizedlist>
-        </listitem>
-      </itemizedlist>
-
-      <remark>Deleted this additional content type: "In special
-      circumstances(ch03-sending-any-type-of-object), an object of any type."
-      Also deleted the following bulleted items: (1) Each isolate has a
-      ReceivePort, which is available as the <literal
-      moreinfo="none">port</literal> variable. Because all Dart code runs
-      inside an isolate, even <literal>main()</literal> has access to a port
-      object. (2) When a web application is compiled to JavaScript, its
-      isolates can be implemented as Web workers. When running in Dartium,
-      isolates run in the VM. (3) In the standalone VM, the
-      <literal>main()</literal> function runs in the first isolate (also known
-      as the <emphasis>root isolate</emphasis>). When the root isolate
-      terminates, it terminates the whole VM, regardless of whether other
-      isolates are still running. For more information, see
-      ch03-keeping-the-root-isolate-alive.</remark>
-
-      <remark>Removed section on Using Isolates(ch03-using-isolates)
-      (subsections: [Spawning isolates](ch03-spawning-isolates), [Sending
-      messages](ch03-sending-messages), [Sending any type of
-      object](ch03-sending-any-type-of-object), [Receiving
-      messages](ch03-receiving-messages) [Receivingn
-      replies](ch03-receiving-replies) [Keeping the root isolate
-      alive](ch03-keeping-the-root-isolate-alive)).</remark>
-    </sect2>
-
-    <sect2 id="ch03-more-information-11">
-      <title>More Information</title>
-
-      <para>See the API docs for the <ulink
-      url="http://api.dartlang.org/dart_isolate.html">dart:isolate
-      library,</ulink> as well as for <ulink
-      url="http://api.dartlang.org/dart_isolate/SendPort.html">SendPort</ulink>
-      and <ulink role="keep-together" security=""
-      url="http://api.dartlang.org/dart_isolate/ReceivePort.html">ReceivePort.</ulink></para>
-    </sect2>
-  </sect1>
-
   <sect1 id="ch03-dartio---file-and-socket-io-for-command-line-apps">
     <title>dart:io - I/O for Command-Line Apps</title>
 
     <para>The <ulink url="http://api.dartlang.org/io.html">dart:io
     library</ulink> provides APIs to deal with files, directories, processes,
     sockets, and HTTP connections. Only command-line apps can use dart:io—not
     web apps.</para>
 
     <para>In general, the dart:io library implements and promotes an
     asynchronous API. Synchronous methods can easily block the event loop,
@@ skipping 476 matching lines @@
 
     <para>The dart:mirrors library provides basic reflection abilities to
     Dart. Use mirrors to query the structure of your program and to
     dynamically invoke functions or methods at runtime. Mirrors can also work
     on static source code. For example, the dartdoc tool (which generates HTML
     docs from Dart source code) uses source-code mirrors.</para>
 
     <para>The dart:mirrors library works in both web apps and command-line
     apps. To use it, import dart:mirrors.</para>
 
-    <note>
-      <para>The dart:mirrors library is still under development. Its API might
-      change slightly as a result of user feedback.</para>
-    </note>
+    <warning>
+      <para>Using dart:mirrors can cause dart2js to generate very large
+      JavaScript files.</para>
+
+      <para>The current workaround is to add a <literal>@MirrorsUsed</literal>
+      annotation before the import of dart:mirrors. For details, see the
+      <ulink
+      url="http://api.dartlang.org/dart_mirrors/MirrorsUsed.html">MirrorsUsed</ulink>
+      API documentation. This workaround might change, as the dart:mirrors
+      library is still under development.</para>
+    </warning>
 
     <sect2 id="ch03-mirrors-symbols">
       <title>Symbols</title>
 
       <para>The mirror system represents the names of Dart declarations
       (classes, fields, and so on) by instances of the class <ulink
       url="http://api.dartlang.org/dart_core/Symbol.html">Symbol</ulink>.
       Symbols help compilers like dart2js produce efficient output, even when
       minified.</para>
 
@@ skipping 26 matching lines @@
 assert('MyClass' == MirrorSystem.getName(className));
 </screen>
     </sect2>
 
     <sect2 id="ch03-mirrors-introspection">
       <title>Introspection</title>
 
       <para>Use mirrors to introspect the running program's structure. You can
       inspect classes, libraries, instances, and more.</para>
 
-      <note>
-        <para>The dart:mirrors library changed recently. We'll update this
-        section soon to reflect the new API. <remark> {PENDING: update!!!}
-        Removed the following: The examples in this section use the following
-        Person class: class Person { String firstName; String lastName; int
-        age; Person(this.firstName, this.lastName, this.age); String get
-        fullName =&gt; '$firstName $lastName'; void greet(String other) {
-        print('Hello there, $other!'); } } To begin, you need to
-        <emphasis>reflect</emphasis> on a class or object to get its
-        <emphasis>mirror</emphasis>. SECT3: Class Mirrors. Reflect on a Type
-        to get its ClassMirror. {e.g.} You can also call
-        <literal>runtimeType</literal> to get a Type from an instance. {e.g.}
-        Once you have a ClassMirror, you can get a class's constructors,
+      <para>The examples in this section use the following Person
+      class:</para>
+
+      <screen format="linespecific"><remark>lang-dart
+ch03/mirrors.dart
+</remark>class Person {
+  String firstName;
+  String lastName;
+  int age;
+  
+  Person(this.firstName, this.lastName, this.age);
+
+  String get fullName =&gt; '$firstName $lastName';
+
+  void greet(String other) {
+    print('Hello there, $other!');
+  }
+}</screen>
+
+      <para>To begin, you need to <emphasis>reflect</emphasis> on a class or
+      object to get its <emphasis>mirror</emphasis>.</para>
+
+      <sect3 id="ch03-mirrors-class-inspect">
+        <title>Class Mirrors</title>
+
+        <para>Reflect on a Type to get its ClassMirror.</para>
+
+        <screen format="linespecific"><remark>lang-dart
+ch03/mirrors.dart
+</remark>ClassMirror mirror = reflectClass(Person);
+
+assert('Person' == MirrorSystem.getName(mirror.simpleName));</screen>
+
+        <para>You can also call <literal>runtimeType</literal> to get a Type
+        from an instance.</para>
+
+        <screen format="linespecific"><remark>lang-dart
+ch03/mirrors.dart
+</remark>var person = new Person('Bob', 'Smith', 33);
+ClassMirror mirror = reflectClass(person.runtimeType);
+
+assert('Person' == MirrorSystem.getName(mirror.simpleName));</screen>
+
+        <para>Once you have a ClassMirror, you can get a class's constructors,
         fields, and more. Here is an example of listing the constructors of a
-        class. {e.g.} Here is an example of listing all of the fields declared
-        by a class. {e.g.} For a full list of methods, consult the <ulink
+        class.</para>
+
+        <screen format="linespecific"><remark>lang-dart
+ch03/mirrors.dart
+</remark>showConstructors(ClassMirror mirror) {
+  var methods = mirror.declarations.values.where((m) =&gt; m is MethodMirror);
+  var constructors = methods.where((m) =&gt; m.isConstructor);
+  
+  constructors.forEach((m) {
+    print('The constructor ${m.simpleName} has ${m.parameters.length} parameters.');
+  });
+}</screen>
+
+        <para>Here is an example of listing all of the fields declared by a
+        class.</para>
+
+        <screen><remark>lang-dart
+ch03/mirrors.dart
+</remark>showFields(ClassMirror mirror) {
+  var fields = mirror.declarations.values.where((m) =&gt; m is VariableMirror);
+
+  fields.forEach((VariableMirror m) {
+    var finalStatus = m.isFinal ? 'final' : 'not final';
+    var privateStatus = m.isPrivate ? 'private' : 'not private';
+    var typeAnnotation = m.type.simpleName;
+
+    print('The field ${m.simpleName} is $privateStatus and $finalStatus and is annotated '
+          'as $typeAnnotation');
+  });
+}</screen>
+
+        <para>For a full list of methods, consult the <ulink
         url="http://api.dartlang.org/dart_mirrors/ClassMirror.html">API docs
-        for ClassMirror</ulink>. SECT3: Instance Mirrors. Reflect on an object
-        to get an InstanceMirror. {e.g.} If you have an InstanceMirror and you
-        want to get the object that it reflects, use
-        <literal>reflectee</literal>. This works only if the current isolate
-        knows about the type of the reflectee. Remember, mirrors work across
-        isolates, and one isolate might contain a class that is not in the
-        current isolate. Once you have an InstanceMirror, you can invoke
-        methods and call getters and setters. For a full list of methods,
-        consult the <ulink
-        url="http://api.dartlang.org/dart_mirrors/InstanceMirror.html">API
-        docs for InstanceMirror</ulink>. SECT2: Invocation. {PENDING: To be
-        written} SECT3: get and set fields. SECT3: invoke. SECT3: delegate
-        </remark></para>
-      </note>
+        for ClassMirror</ulink>.</para>
+      </sect3>
+
+      <sect3 id="ch03-mirrors-instance-inspect">
+        <title>Instance Mirrors</title>
+
+        <para>Reflect on an object to get an InstanceMirror.</para>
+
+        <screen><remark>lang-dart
+ch03/mirrors.dart
+</remark>var p = new Person('Bob', 'Smith', 42);
+InstanceMirror mirror = reflect(p);</screen>
+
+        <para>If you have an InstanceMirror and you want to get the object
+        that it reflects, use <literal>reflectee</literal>.</para>
+
+        <screen><remark>lang-dart
+ch03/mirrors.dart
+</remark>var person = mirror.reflectee;
+assert(identical(p, person));</screen>
+      </sect3>
+    </sect2>
+
+    <sect2 id="ch03-mirrors-invocation">
+      <title>Invocation</title>
+
+      <para>Once you have an InstanceMirror, you can invoke methods and call
+      getters and setters. For a full list of methods, consult the <ulink
+      url="http://api.dartlang.org/dart_mirrors/InstanceMirror.html">API docs
+      for InstanceMirror</ulink>.</para>
+
+      <sect3 id="ch03-mirrors-invoke">
+        <title>Invoke Methods</title>
+
+        <para>Use InstanceMirror's <literal>invoke()</literal> method to
+        invoke a method on an object. The first parameter specifies the method
+        to be invoked, and the second is a list of positional arguments to the
+        method. An optional third parameter lets you specify named
+        arguments.</para>
+
+        <screen><remark>lang-dart
+ch03/mirrors.dart
+</remark>var p = new Person('Bob', 'Smith', 42);
+InstanceMirror mirror = reflect(p);
+
+mirror.invoke(#greet, ['Shailen']);</screen>
+      </sect3>
+
+      <sect3 id="ch03-mirrors-getset-fields">
+        <title>Get and Set Properties</title>
+
+        <para>Use InstanceMirror's <literal>getField()</literal> and
+        <literal>setField()</literal> methods to get and set properties of an
+        object.</para>
+
+        <screen><remark>lang-dart
+ch03/mirrors.dart
+</remark>
+var p = new Person('Bob', 'Smith', 42);
+InstanceMirror mirror = reflect(p);
+
+// Get the value of a property.
+var fullName = mirror.getField(#fullName).reflectee;
+assert(fullName == 'Bob Smith');
+  
+// Set the value of a property.
+mirror.setField(#firstName, 'Mary');
+assert(p.firstName == 'Mary');</screen>
+      </sect3>
+    </sect2>
+
+    <sect2 id="ch03-more-information-mirrors">
+      <title>More Information</title>
+
+      <para>The article <ulink
+      url="https://www.dartlang.org/articles/reflection-with-mirrors/">Reflection
+      in Dart with Mirrors</ulink> has more information and examples. Also see
+      the API docs for <ulink
+      url="http://api.dartlang.org/dart_mirrors.html">dart:mirror,</ulink>
+      especially <ulink
+      url="http://api.dartlang.org/dart_mirrors/MirrorsUsed.html">MirrorsUsed</ulink>,
+      <ulink
+      url="http://api.dartlang.org/dart_mirrors/ClassMirror.html">ClassMirror,</ulink>
+      and <ulink
+      url="http://api.dartlang.org/dart_mirrors/InstanceMirror.html">InstanceMirror.</ulink></para>
     </sect2>
   </sect1>
 
   <sect1 id="ch03-summary">
     <title>Summary</title>
 
     <para>This chapter introduced you to the most commonly used functionality
     in many of Dart’s built-in libraries. It didn’t cover all the built-in
     libraries, however. Others that you might want to look into include <ulink
     url="http://api.dartlang.org/dart_collection.html">dart:collection,</ulink>
+    <ulink
+    url="http://api.dartlang.org/dart_isolate.html">dart:isolate,</ulink>
     <ulink url="http://api.dartlang.org/dart_js.html">dart:js,</ulink> and
     <ulink
     url="http://api.dartlang.org/dart_typed_data.html">dart:typed_data.</ulink>
     You can get yet more libraries by using the pub tool, discussed in the
     next chapter. The <ulink
     url="http://pub.dartlang.org/packages/args">args,</ulink> <ulink
     url="http://api.dartlang.org/logging.html">logging,</ulink> <ulink
     url="http://pub.dartlang.org/packages/polymer">polymer,</ulink> and <ulink
     url="http://api.dartlang.org/unittest.html" wordsize=""><phrase
     role="keep-together">unittest</phrase></ulink> libraries are just a
     sampling of what you can install using pub.</para>
   </sect1>
 </chapter>