Upgrade to 1.0 and switch clients to dom-repeat where needed.

third_party/polymer/v0_8/components/paper-icon-button/README.md

Index: third_party/polymer/v0_8/components/paper-icon-button/README.md
diff --git a/third_party/polymer/v0_8/components/paper-icon-button/README.md b/third_party/polymer/v0_8/components/paper-icon-button/README.md
index 633a113f1cf8af5487432cf535a1d94de3f1404f..96dbf8e0063844b5c1f33c3215d6af5673621f47 100644
--- a/third_party/polymer/v0_8/components/paper-icon-button/README.md
+++ b/third_party/polymer/v0_8/components/paper-icon-button/README.md
@@ -1,4 +1,49 @@
 paper-icon-button
 =================
 
-See the [component page](http://www.polymer-project.org/docs/elements/paper-elements.html#paper-icon-button) for more information.
+Material Design: <a href="http://www.google.com/design/spec/components/buttons.html">Buttons</a>
+
+`paper-icon-button` is a button with an image placed at the center. When the user touches
+the button, a ripple effect emanates from the center of the button.
+
+`paper-icon-button` includes a default icon set.  Use `icon` to specify which icon
+from the icon set to use.
+
+```html
+<paper-icon-button icon="menu"></paper-icon-button>
+```
+
+See [`iron-iconset`](#iron-iconset) for more information about
+how to use a custom icon set.
+
+Example:
+
+```html
+<link href="path/to/iron-icons/iron-icons.html" rel="import">
+
+<paper-icon-button icon="favorite"></paper-icon-button>
+<paper-icon-button src="star.png"></paper-icon-button>
+```
+
+Styling
+-------
+
+Style the button with CSS as you would a normal DOM element. If you are using the icons
+provided by `iron-icons`, they will inherit the foreground color of the button.
+
+```html
+<!-- make a red "favorite" button -->
+<paper-icon-button icon="favorite" style="color: red;"></paper-icon-button>
+```
+
+By default, the ripple is the same color as the foreground at 25% opacity. You may
+customize the color using this selector:
+
+```css
+/* make #my-button use a blue ripple instead of foreground color */
+#my-button::shadow #ripple {
+  color: blue;
+}
+```
+
+The opacity of the ripple is not customizable via CSS.