fix text to reflect new code

Author: kwalrath

public/docs/_examples/dependency-injection/dart/lib/app_component_2.dart

@@ -21,7 +21,6 @@ import 'logger_service.dart';
     ],
     providers: const [
       Logger,
-      // #docregion provider-config
       const Provider(AppConfig, useValue: config1)
     ])
 class AppComponent {

public/docs/_examples/dependency-injection/dart/lib/app_config.dart

@@ -2,14 +2,16 @@
 // #docregion token
 import 'package:angular2/core.dart';
 
-//#docregion config
+//#docregion const-class
 @Injectable()
 class AppConfig {
   final apiEndpoint;
   final String title;
 
   const AppConfig(this.apiEndpoint, this.title);
 }
+//#enddocregion const-class
 
+//#docregion const-object
 const config1 = const AppConfig('api.heroes.com', 'Dependency Injection');
-//#enddocregion config
+//#enddocregion const-object

public/docs/_examples/dependency-injection/dart/lib/providers_component.dart

@@ -221,18 +221,15 @@ class ProviderComponent8 {
     selector: 'provider-9',
     template: '{{log}}',
 // #docregion providers-9
-    providers: const [const Provider(AppConfig, useValue: config1)]
-// . . .
+providers: const [const Provider(AppConfig, useValue: config1)]
 // #enddocregion providers-9
 )
 class ProviderComponent9 implements OnInit {
   AppConfig _config;
   String log;
 
-  // #docregion providers-9
   ProviderComponent9(AppConfig this._config);
 
-  // #enddocregion providers-9
   @override
   void ngOnInit() {
     log = 'appConfigToken Application title is ${_config.title}';

public/docs/dart/latest/guide/dependency-injection.jade

@@ -189,34 +189,41 @@ code-example(format, language="html").
 +includeShared('{ts}', 'providers-aliased-1')
 +makeExample('dependency-injection/dart/lib/providers_component.dart','providers-6a')(format=".")
 +includeShared('{ts}', 'providers-aliased-2')
-+makeExample('dependency-injection/dart/lib/providers_component.dart','providers-6b')(format=".")
+- var stylePattern = { otl: /(useExisting.*\))/gm };
++makeExample('dependency-injection/dart/lib/providers_component.dart','providers-6b','', stylePattern)(format=".")
 
 +includeShared('{ts}', 'providers-value-1')
 :marked
   By specifying a `useValue` parameter to `Provider`,
   we can provide objects directly,
   instead of asking the injector to create an instance of a class.
 
-  In Dart code, `useValue` is handy for passing configuration information,
-  often using literals such as strings, lists, and maps.
+  Because Dart annotations must be compile-time constants,
+  `useValue` is often used with string or list literals.
+  However, you can also use `useValue` with constant objects.
 
-+makeExample('dependency-injection/dart/lib/providers_component.dart','providers-usevalue')(format=".")
+  To create a class that can provide constant objects,
+  make sure all its instance variables are `final`,
+  and give it a `const` constructor:
+
++makeExample('dependency-injection/dart/lib/app_config.dart','const-class','lib/app_config.dart (excerpt)')(format='.')
+
+:marked
+  To create a constant instance of that class, use `const` instead of `new`:
+
++makeExample('dependency-injection/dart/lib/app_config.dart','const-object','lib/app_config.dart (excerpt)')(format='.')
+
+:marked
+  Then specify the object using the `useValue` argument to `Provider`:
+
+- var stylePattern = { otl: /(useValue.*\))/gm };
++makeExample('dependency-injection/dart/lib/providers_component.dart','providers-9','', stylePattern)(format='.')
 
 :marked
   See more `useValue` examples in the
   [Non-class dependencies](#non-class-dependencies) and
   [OpaqueToken](#opaquetoken) sections.
 
-.callout.is-helpful
-  header Dart difference: Creating objects
-  :marked
-    TypeScript Angular code sometimes uses `useValue` to pass in
-    objects created without using a constructor.
-    Dart doesn't support instantiating random objects outside of constructors.
-    Another reason `useValue` is less common in Dart is that
-    the argument's value must be constant
-    (because Dart annotations must have constant values).
-
 +includeShared('{ts}', 'providers-factory-1')
 +makeExample('dependency-injection/dart/lib/heroes/hero_service.dart','internals', 'lib/heroes/hero_service.dart (excerpt)')(format='.')
 +includeShared('{ts}', 'providers-factory-2')
@@ -225,7 +232,7 @@ code-example(format, language="html").
 +makeExample('dependency-injection/dart/lib/heroes/hero_service_provider.dart','provider', 'lib/heroes/hero_service_provider.dart (excerpt)')(format='.')
 +includeShared('{ts}', 'providers-factory-4')
 +includeShared('{ts}', 'providers-factory-5')
-- var stylePattern = { pnk: /(providers.*),$/gm };
+- var stylePattern = { otl: /(providers.*),$/gm };
 +makeTabs(
   `dependency-injection/dart/lib/heroes/heroes_component.dart,
   dependency-injection/dart/lib/heroes/heroes_component_1.dart`,
@@ -247,6 +254,7 @@ code-example(format, language="html").
     every class implicitly defines an interface,
     so interface names are just class names.
 +includeShared('{ts}', 'tokens-non-class-deps-1')
+[PENDING: fix!!]
 +makeExample('dependency-injection/dart/lib/app_config.dart','config','lib/app_config.dart (excerpt)')(format='.')
 :marked
   We know we can register an object with a [value provider](#value-provider).

public/docs/ts/latest/guide/dependency-injection.jade

@@ -637,16 +637,13 @@ code-example(format, language="html").
   ### Value providers
 // #enddocregion providers-value-1
 
-// #docregion providers-value-2
+// Typescript only
 :marked
   Sometimes it's easier to provide a ready-made object rather than ask the injector to create it from a class.
 +makeExample('dependency-injection/ts/app/providers.component.ts','silent-logger')(format=".")
-// #enddocregion providers-value-2
-// #docregion providers-value-3
 :marked
   Then we register a provider with the `useValue` option,
   which makes this object play the logger role.
-// #enddocregion providers-value-3
 +makeExample('dependency-injection/ts/app/providers.component.ts','providers-7')(format=".")
 
 // #docregion providers-factory-1
@@ -753,7 +750,7 @@ code-example(format, language="html").
 
 // #docregion tokens-non-class-deps-1
 - var lang = current.path[1]
-- var objectexamples = lang == 'dart' ? 'an object, such as a string, list, or map literal' : 'a string, a function, or an object'
+- var objectexamples = lang == 'dart' ? 'a string or list literal, or maybe a function' : 'a string, a function, or an object'
 // Is function injection useful? Should we show it?
 - var hashes = lang == 'dart' ? 'They might be maps like this one:' : 'They tend to be object hashes like this one:'
 :marked