[observe] use consistent comment style

pkg/observe/lib/src/observable_map.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.
 
 library observe.src.observable_map;
 
 import 'dart:collection';
 import 'package:observe/observe.dart';
 
 
 // TODO(jmesserly): this needs to be faster. We currently require multiple
 // lookups per key to get the old value.
 // TODO(jmesserly): this doesn't implement the precise interfaces like
 // LinkedHashMap, SplayTreeMap or HashMap. However it can use them for the
 // backing store.
 
 // TODO(jmesserly): should we summarize map changes like we do for list changes?
 class MapChangeRecord<K, V> extends ChangeRecord {
   // TODO(jmesserly): we could store this more compactly if it matters, with
   // subtypes for inserted and removed.
 
-  /** The map key that changed. */
+  /// The map key that changed.
   final K key;
 
-  /** The previous value associated with this key. */
+  /// The previous value associated with this key.
   final V oldValue;
 
-  /** The new value associated with this key. */
+  /// The new value associated with this key.
   final V newValue;
 
-  /** True if this key was inserted. */
+  /// True if this key was inserted.
   final bool isInsert;
 
-  /** True if this key was removed. */
+  /// True if this key was removed.
   final bool isRemove;
 
   MapChangeRecord(this.key, this.oldValue, this.newValue)
       : isInsert = false, isRemove = false;
 
   MapChangeRecord.insert(this.key, this.newValue)
       : isInsert = true, isRemove = false, oldValue = null;
 
   MapChangeRecord.remove(this.key, this.oldValue)
       : isInsert = false, isRemove = true, newValue = null;
 
   String toString() {
     var kind = isInsert ? 'insert' : isRemove ? 'remove' : 'set';
     return '#<MapChangeRecord $kind $key from: $oldValue to: $newValue>';
   }
 }
 
-/**
- * Represents an observable map of model values. If any items are added,
- * removed, or replaced, then observers that are listening to [changes]
- * will be notified.
- */
+/// Represents an observable map of model values. If any items are added,
+/// removed, or replaced, then observers that are listening to [changes]
+/// will be notified.
 class ObservableMap<K, V> extends ChangeNotifier implements Map<K, V> {
   final Map<K, V> _map;
 
-  /** Creates an observable map. */
+  /// Creates an observable map.
   ObservableMap() : _map = new HashMap<K, V>();
 
-  /** Creates a new observable map using a [LinkedHashMap]. */
+  /// Creates a new observable map using a [LinkedHashMap].
   ObservableMap.linked() : _map = new LinkedHashMap<K, V>();
 
-  /** Creates a new observable map using a [SplayTreeMap]. */
+  /// Creates a new observable map using a [SplayTreeMap].
   ObservableMap.sorted() : _map = new SplayTreeMap<K, V>();
 
-  /**
-   * Creates an observable map that contains all key value pairs of [other].
-   * It will attempt to use the same backing map type if the other map is a
-   * [LinkedHashMap], [SplayTreeMap], or [HashMap]. Otherwise it defaults to
-   * [HashMap].
-   *
-   * Note this will perform a shallow conversion. If you want a deep conversion
-   * you should use [toObservable].
-   */
+  /// Creates an observable map that contains all key value pairs of [other].
+  /// It will attempt to use the same backing map type if the other map is a
+  /// [LinkedHashMap], [SplayTreeMap], or [HashMap]. Otherwise it defaults to
+  /// [HashMap].
+  ///
+  /// Note this will perform a shallow conversion. If you want a deep conversion
+  /// you should use [toObservable].
   factory ObservableMap.from(Map<K, V> other) {
     return new ObservableMap<K, V>.createFromType(other)..addAll(other);
   }
 
-  /** Like [ObservableMap.from], but creates an empty map. */
+  /// Like [ObservableMap.from], but creates an empty map.
   factory ObservableMap.createFromType(Map<K, V> other) {
     ObservableMap result;
     if (other is SplayTreeMap) {
       result = new ObservableMap<K, V>.sorted();
     } else if (other is LinkedHashMap) {
       result = new ObservableMap<K, V>.linked();
     } else {
       result = new ObservableMap<K, V>();
     }
     return result;
@@ skipping 61 matching lines @@
       });
       notifyPropertyChange(#length, len, 0);
     }
     _map.clear();
   }
 
   void forEach(void f(K key, V value)) => _map.forEach(f);
 
   String toString() => Maps.mapToString(this);
 }