From 5d544c0405422e1356e5c25e7739e58afa8b0205 Mon Sep 17 00:00:00 2001
From: Chirayu Krishnappa <chirayu@chirayuk.com>
Date: Wed, 5 Feb 2014 12:42:56 -0800
Subject: [PATCH] docs(ng-class): expound on the map syntax

Closes #221
---
 lib/directive/ng_class.dart | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/lib/directive/ng_class.dart b/lib/directive/ng_class.dart
index 171166a88..73f86eb80 100644
--- a/lib/directive/ng_class.dart
+++ b/lib/directive/ng_class.dart
@@ -19,14 +19,28 @@ part of angular.directive;
  *
  * index.html:
  *
- *     <p ng-class="{strike: strike, bold: bold, red: red}">Map Syntax Example</p>
+ *     <!--
+ *       The map syntax:
+ *
+ *           ng-class="{key1: value1, key2: value2, ...}"
+ *
+ *       results in only adding CSS classes represented by the map keys when
+ *       the corresponding value expressions are truthy.
+ *
+ *       To use a css class that contains a hyphen (such as line-through in this
+ *       example), you should quote the name to make it a valid map key.  You
+ *       may, of course, quote all the map keys for consistency.
+ *     -->
+ *     <p ng-class="{'line-through': strike, bold: bold, red: red}">Map Syntax Example</p>
  *     <input type="checkbox" ng-model="bold"> bold
  *     <input type="checkbox" ng-model="strike"> strike
  *     <input type="checkbox" ng-model="red"> red
  *     <hr>
+ *
  *     <p ng-class="style">Using String Syntax</p>
  *     <input type="text" ng-model="style" placeholder="Type: bold strike red">
  *     <hr>
+ *
  *     <p ng-class="[style1, style2, style3]">Using Array Syntax</p>
  *     <input ng-model="style1" placeholder="Type: bold"><br>
  *     <input ng-model="style2" placeholder="Type: strike"><br>
@@ -37,6 +51,9 @@ part of angular.directive;
  *     .strike {
  *       text-decoration: line-through;
  *     }
+ *     .line-through {
+ *       text-decoration: line-through;
+ *     }
  *     .bold {
  *         font-weight: bold;
  *     }