vicb · Oct 11, 2015 · Oct 27, 2015 · Oct 7, 2015 · Oct 27, 2015
diff --git a/modules/angular2/src/core/change_detection/pipe_transform.ts b/modules/angular2/src/core/change_detection/pipe_transform.ts
@@ -33,22 +33,23 @@
 export interface PipeTransform { transform(value: any, args: any[]): any; }
 
 /**
- * To create a stateful Pipe, you should implement this interface.
+ * To create a stateful Pipe, you should implement this interface and set the `pure`
+ * parameter to `false` in the {@link PipeMetadata}.
  *
  * A stateful pipe may produce different output, given the same input. It is
  * likely that a stateful pipe may contain state that should be cleaned up when
  * a binding is destroyed. For example, a subscription to a stream of data may need to
  * be disposed, or an interval may need to be cleared.
  *
- * ### Example ([live demo](http://plnkr.co/edit/hlaejwQAmWayxwc5YXQE?p=preview))
+ * ### Example ([live demo](http://plnkr.co/edit/i8pm5brO4sPaLxBx56MR?p=preview))
  *
  * In this example, a pipe is created to countdown its input value, updating it every
  * 50ms. Because it maintains an internal interval, it automatically clears
  * the interval when the binding is destroyed or the countdown completes.
  *
  * ```
  * import {Pipe, PipeTransform} from 'angular2/angular2'
- * @Pipe({name: 'countdown'})
+ * @Pipe({name: 'countdown', pure: false})
  * class CountDown implements PipeTransform, PipeOnDestroy {
  *   remainingTime:Number;
  *   interval:SetInterval;

diff --git a/modules/angular2/src/core/di/metadata.ts b/modules/angular2/src/core/di/metadata.ts
@@ -128,8 +128,6 @@ export class InjectableMetadata {
  *
  * @Injectable()
  * class NeedsDependency {
- *   dependency;
-
  *   dependency;
  *   constructor(@Self() dependency:Dependency) {
  *     this.dependency = dependency;

diff --git a/modules/angular2/src/core/metadata/di.ts b/modules/angular2/src/core/metadata/di.ts
@@ -102,8 +102,8 @@ export class AttributeMetadata extends DependencyMetadata {
  *   <div #findme>...</div>
  * </seeker>
  *
- * @Component({ selector: 'foo' })
- * class seeker {
+ * @Component({ selector: 'seeker' })
+ * class Seeker {
  *   constructor(@Query('findme') elList: QueryList<ElementRef>) {...}
  * }
  * ```
@@ -120,7 +120,7 @@ export class AttributeMetadata extends DependencyMetadata {
  * </seeker>
  *
  *  @Component({
- *   selector: 'foo'
+ *   selector: 'seeker'
  * })
  * class Seeker {
  *   constructor(@Query('findMe, findMeToo') elList: QueryList<ElementRef>) {...}

diff --git a/modules/angular2/src/http/http.ts b/modules/angular2/src/http/http.ts
@@ -61,7 +61,7 @@ function mergeOptions(defaultOpts, providedOpts, method, url): RequestOptions {
  * ### Example
  *
  * ```
- * http.get('people.json').observer({next: (value) => this.people = people});
+ * http.get('people.json').observer({next: (value) => this.people = value});
  * ```
  *
  * The default construct used to perform requests, `XMLHttpRequest`, is abstracted as a "Backend" (