add one-liner docs to dart:developer

sdk/lib/developer/developer.dart

Index: sdk/lib/developer/developer.dart
diff --git a/sdk/lib/developer/developer.dart b/sdk/lib/developer/developer.dart
index 4df565e4222a5aeca2d8402bd99386f48c160cf6..03c75c1fbb0c39eecdb3717ecdebb4f0bf94c035 100644
--- a/sdk/lib/developer/developer.dart
+++ b/sdk/lib/developer/developer.dart
@@ -2,9 +2,9 @@
 // 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.
 
-/// ## Status: Unstable
+/// Interact with developer tools such as the debugger and inspector.
 ///
-/// The dart:developer library is unstable and its API might change slightly
+/// The dart:developer library is _unstable_ and its API might change slightly
 /// as a result of developer feedback. This library is platform dependent and
 /// therefore it has implementations for both dart2js and the Dart VM. Both are
 /// under development and may not support all operations yet.
@@ -15,9 +15,12 @@ import 'dart:convert';
 
 part 'profiler.dart';
 
-/// If [when] is true, stop the program as if a breakpoint where hit at the
-/// following statement. Returns the value of [when]. Some debuggers may
+/// If [when] is true, stop the program as if a breakpoint were hit at the
+/// following statement.
+/// 
+/// Returns the value of [when]. Some debuggers may
 /// display [msg].
+/// 
 /// NOTE: When invoked, the isolate will not return until a debugger
 /// continues execution. When running in the Dart VM the behaviour is the same
 /// regardless of whether or not a debugger is connected. When compiled to
@@ -25,6 +28,7 @@ part 'profiler.dart';
 /// that does.
 external bool debugger({bool when: true, String msg});
 
-/// Send a reference to [object] to any attached debuggers so they may open an
-/// inspector on the object. Returns the argument.
+/// Send a reference to [object] to any attached debuggers.
+/// 
+/// Debuggers may open an inspector on the object. Returns the argument.
 external inspect(object);