Angular.equals - Adding an example.

src/Angular.js

@@ -978,6 +978,40 @@ function shallowCopy(src, dst) {
  * @param {*} o1 Object or value to compare.
  * @param {*} o2 Object or value to compare.
  * @returns {boolean} True if arguments are equal.
+ * @example
+ <example module="equalsExample">
+ <file name="index.html">
+ <div ng-controller="ExampleController">
+    <form novalidate>
+      <h3>User 1</h3> Name:
+      <input type="text" ng-model="user1.name"> Age:
+      <input type="number" ng-model="user1.age">
+
+      <h3>User 2</h3> Name:
+      <input type="text" ng-model="user2.name"> Age:
+      <input type="number" ng-model="user2.age">
+
+      <div>
+        <br/>
+        <input type="button" value="Compare" ng-click="compare()">
+      </div>
+      <pre>User 1 = {{user1 | json}}</pre>
+      <pre>User 2 = {{user2 | json}}</pre>
+      <pre>{{result}}</pre>
+    </form>
+  </div>
+  <script>
+    angular.module('equalsExample', []) .controller('ExampleController', ['$scope', function($scope) {
+      $scope.user1={};
+      $scope.user2={};
+      $scope.result;
+      $scope.compare = function() {
+        $scope.result = angular.equals($scope.user1, $scope.user2);
+      };
+    }]);
+  </script>
+ </file>
+ <example>
  */
 function equals(o1, o2) {
   if (o1 === o2) return true;