From 3c1f4969ebfa266deddafc4035fee507094c89ce Mon Sep 17 00:00:00 2001
From: Jeremy Elbourn <jelbourn@google.com>
Date: Wed, 18 May 2016 16:08:49 -0700
Subject: [PATCH] docs(button): more detail on MdAnchor.

---
 src/components/button/README.md | 11 +++++++++--
 src/components/button/button.ts |  4 ++++
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/src/components/button/README.md b/src/components/button/README.md
index dbf36dc73985..0f3d3bec6fbc 100644
--- a/src/components/button/README.md
+++ b/src/components/button/README.md
@@ -1,6 +1,13 @@
 # md-button
 
-`md-button` is an HTML `<button>` or `<a>` tag enhanced with styling and animation to match the [spec of a Material Design button](https://www.google.com/design/spec/components/buttons.html).
+`md-button` is an HTML `<button>` or `<a>` tag enhanced with styling and animation to match the
+[Material Design button spec](https://www.google.com/design/spec/components/buttons.html).
+
+Users should employ a button element (`<button>`) when clicking triggers some action in the current
+view *without navigating*. An anchor element (`<a>`) should be used when clicking *navigates*
+the user to another URL. Depending on which element is used, the component will either be an
+instance of `MdButton` or `MdAnchor`. Visually, the two are identical.
+
 
 ### Button types
 
@@ -103,4 +110,4 @@ Properties:
 | Name | Type | Description |
 | --- | --- | --- |
 | `color` | `"primary"|"accent"|"warn"` | The color palette of the button
-| `disabled` | boolean | Whether or not the button is disabled
\ No newline at end of file
+| `disabled` | boolean | Whether or not the button is disabled
diff --git a/src/components/button/button.ts b/src/components/button/button.ts
index ace5c0da0994..3a0a6fb1c8fe 100644
--- a/src/components/button/button.ts
+++ b/src/components/button/button.ts
@@ -6,6 +6,7 @@ import {
   ChangeDetectionStrategy,
   ElementRef,
   Renderer,
+  Type,
 } from '@angular/core';
 
 // TODO(jelbourn): Ink ripples.
@@ -132,3 +133,6 @@ export class MdAnchor extends MdButton {
     }
   }
 }
+
+
+export const MD_BUTTON_DIRECTIVES: Type[] = [MdButton, MdAnchor];