Prepare pubspec/CHANGELOG for version 0.1.2

lib/datastore.dart

 // Copyright (c) 2014, 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 library provides a low-level API for accessing Google's Cloud
 /// Datastore.
 ///
 /// For more information on Cloud Datastore, please refer to the following
 /// developers page: https://cloud.google.com/datastore/docs
 library gcloud.datastore;
 
 import 'dart:async';
 
 import 'common.dart' show Page;
 import 'service_scope.dart' as ss;
 
 const Symbol _datastoreKey = #_gcloud.datastore;
 
 /// Access the [Datastore] object available in the current service scope.
 ///
 /// The returned object will be the one which was previously registered with
 /// [registerDatastoreService] within the current (or a parent) service scope.
 ///
 /// Accessing this getter outside of a service scope will result in an error.
+/// See the `package:gcloud/service_scope.dart` library for more information.
 Datastore get datastoreService => ss.lookup(_datastoreKey);
 
 /// Registers the [Datastore] object within the current service scope.
 ///
 /// The provided `datastore` object will be avilable via the top-level
 /// `datastore` getter.
 ///
 /// Calling this function outside of a service scope will result in an error.
 /// Calling this function more than once inside the same service scope is not
 /// allowed.
@@ skipping 375 matching lines @@
   /// If a [transaction] is given, the query will be within this transaction.
   /// But note that arbitrary queries within a transaction are not possible.
   /// A transaction is limited to a very small number of entity groups. Usually
   /// queries with transactions are restricted by providing an ancestor filter.
   ///
   /// Outside of transactions, the result set might be stale. Queries are by
   /// default eventually consistent.
   Future<Page<Entity>> query(
       Query query, {Partition partition, Transaction transaction});
 }