Couple comment tweaks for summaries IDL.

pkg/analyzer/tool/summary/idl.dart

 // Copyright (c) 2015, 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.
 
 /**
  * This file is an "idl" style description of the summary format.  It is not
  * executed directly; instead it is parsed and transformed into code that
  * implements the summary format.
  *
  * The code generation process introduces the following non-typical semantics:
@@ skipping 105 matching lines @@
    * that reference is resolved.
    */
   List<PrelinkedReference> references;
 }
 
 /**
  * Information about the resolution of an [UnlinkedReference].
  */
 class PrelinkedReference {
   /**
-   * Index into [UnlinkedLibrary.dependencies] indicating which imported library
+   * Index into [PrelinkedLibrary.dependencies] indicating which imported library
    * declares the entity being referred to.
    */
   int dependency;
 
   /**
    * The kind of the entity being referred to.  For the pseudo-type `dynamic`,
-   * the kind if [PrelinkedReferenceKind.classOrEnum].
+   * the kind is [PrelinkedReferenceKind.classOrEnum].
    */
   PrelinkedReferenceKind kind;
 
   /**
    * Integer index indicating which unit in the imported library contains the
-   * definition of the entity.  As with indices into [UnlinkedLibrary.units],
+   * definition of the entity.  As with indices into [PrelinkedLibrary.units],
    * zero represents the defining compilation unit, and nonzero values
    * represent parts in the order of the corresponding `part` declarations.
    */
   int unit;
 }
 
 /**
  * Enum used to indicate the kind of entity referred to by a
  * [PrelinkedReference].
  */
@@ skipping 44 matching lines @@
   List<UnlinkedTypeParam> typeParameters;
 
   /**
    * Supertype of the class, or `null` if either (a) the class doesn't
    * explicitly declare a supertype (and hence has supertype `Object`), or (b)
    * the class *is* `Object` (and hence has no supertype).
    */
   UnlinkedTypeRef supertype;
 
   /**
-   * Mixins appering in a `with` clause, if any.
+   * Mixins appearing in a `with` clause, if any.
    */
   List<UnlinkedTypeRef> mixins;
 
   /**
    * Interfaces appearing in an `implements` clause, if any.
    */
   List<UnlinkedTypeRef> interfaces;
 
   /**
    * Field declarations contained in the class.
@@ skipping 419 matching lines @@
    * instantiate it.  Trailing type arguments of type `dynamic` are omitted.
    */
   List<UnlinkedTypeRef> typeArguments;
 }
 
 /**
  * Unlinked summary information about a compilation unit ("part file").  Note
  * that since a declaration can be moved from one part file to another without
  * changing semantics, the declarations themselves aren't stored here; they are
  * stored in [UnlinkedLibrary] and they refer to [UnlinkedUnit]s via an index
  * into [UnlinkedLibrary.units].

[scheglov, 2015/12/15 06:23:33]

This comment also does not look right.
It says that declarations are not stored in the unit, but UnlinkedUnit has
fields for storing declarations.

Also [UnlinkedLibrary.units] does not exist.

[Paul Berry, 2015/12/15 17:35:32]

You're right.  I'll remove the bogus text in my next CL.

  */
 class UnlinkedUnit {
   /**
    * Name of the library (from a "library" declaration, if present).
    */
   String libraryName;
 
   /**
    * Classes declared in the compilation unit.
    */
@@ skipping 69 matching lines @@
   /**
    * Indicates whether the variable is declared using the `const` keyword.
    */
   bool isConst;
 
   /**
    * Indicates whether this variable lacks an explicit type declaration.
    */
   bool hasImplicitType;
 }