Minor doc fix

doc/symbols/jasmine.Spy.html

@@ -412,15 +412,46 @@ ul.inheritsList
 				</div>
 				
 				<div class="description">
-					Jasmine Spies are test doubles that can act as stubs, spies, fakes or when used in an expecation, mocks.
+					Jasmine Spies are test doubles that can act as stubs, spies, fakes or when used in an expecation, mocks.
+
+Spies should be created in test setup, before expectations.  They can then be checked, using the standard Jasmine
+expectation syntax. Spies can be checked if they were called or not and what the calling params were.
+
+A Spy has the following mehtod: wasCalled, callCount, mostRecentCall, and argsForCall (see docs)
+Spies are torn down at the end of every spec.
+
+Note: Do <b>not</b> call new jasmine.Spy() directly - a spy must be created using spyOn, jasmine.createSpy or jasmine.createSpyObj.
 					
 				</div>
 				
 				
 				
-Spies are torn down at the end of every spec.
-
-Note: Do <b>not</b> call new jasmine.Spy() directly - a spy must be created using spyOn, jasmine.createSpy or jasmine.createSpyObj.
+				<pre class="code">// a stub
+var myStub = jasmine.createSpy('myStub');  // can be used anywhere
+
+// spy example
+var foo = {
+  not: function(bool) { return !bool; }
+}
+
+// actual foo.not will not be called, execution stops
+spyOn(foo, 'not');
+
+ // foo.not spied upon, execution will continue to implementation
+spyOn(foo, 'not').andCallThrough();
+
+// fake example
+var foo = {
+  not: function(bool) { return !bool; }
+}
+
+// foo.not(val) will return val
+spyOn(foo, 'not').andCallFake(function(value) {return value;});
+
+// mock example
+foo.not(7 == 7);
+expect(foo.not).wasCalled();
+expect(foo.not).wasCalledWith(true);</pre>
 				
 				
 				
@@ -475,7 +506,12 @@ ul.inheritsList
 					
 					
 					
-						<dt class="heading">See:</dt>
+					<pre class="code">var mySpy = jasmine.createSpy('foo');
+mySpy(1, 2);
+mySpy(7, 8);
+mySpy.mostRecentCall.args = [7, 8];
+mySpy.argsForCall[0] = [1, 2];
+mySpy.argsForCall[1] = [7, 8];</pre>
 					
 					
 
@@ -545,7 +581,9 @@ ul.inheritsList
 					
 					
 					
-					<div class="fixedFont">
+					<pre class="code">var mySpy = jasmine.createSpy('foo');
+mySpy(1, 2);
+mySpy.mostRecentCall.args = [1, 2];</pre>
 					
 					
 
@@ -579,7 +617,14 @@ ul.inheritsList
 					
 					
 					
-					
+					<pre class="code">var baz = function() {
+  // do some stuff, return something
+}
+// defining a spy from scratch: foo() calls the function baz
+var foo = jasmine.createSpy('spy on foo').andCall(baz);
+
+// defining a spy on an existing property: foo.bar() calls an anonymnous function
+spyOn(foo, 'bar').andCall(function() { return 'baz';} );</pre>
 					
 					
 					
@@ -619,7 +664,12 @@ ul.inheritsList
 					
 					
 					
-}
+					<pre class="code">var foo = {
+  bar: function() { // do some stuff }
+}
+
+// defining a spy on an existing property: foo.bar
+spyOn(foo, 'bar').andCallThrough();</pre>
 					
 					
 					
@@ -648,7 +698,11 @@ ul.inheritsList
 					
 					
 					
-				
+					<pre class="code">// defining a spy from scratch: foo() returns 'baz'
+var foo = jasmine.createSpy('spy on foo').andReturn('baz');
+
+// defining a spy on an existing property: foo.bar() returns 'baz'
+spyOn(foo, 'bar').andReturn('baz');</pre>
 					
 					
 					
@@ -688,7 +742,11 @@ ul.inheritsList
 					
 					
 					
-					
+					<pre class="code">// defining a spy from scratch: foo() throws an exception w/ message 'ouch'
+var foo = jasmine.createSpy('spy on foo').andThrow('baz');
+
+// defining a spy on an existing property: foo.bar() throws an exception w/ message 'ouch'
+spyOn(foo, 'bar').andThrow('baz');</pre>
 					
 					
 					
@@ -753,7 +811,15 @@ ul.inheritsList
 					
 					
 					
-							
+					<pre class="code">spyOn(foo, 'bar');
+
+foo.bar();
+
+expect(foo.bar.callCount).toEqual(1);
+
+foo.bar.reset();
+
+expect(foo.bar.callCount).toEqual(0);</pre>
 					
 					
 					
@@ -779,7 +845,7 @@ ul.inheritsList
 <!-- ============================== footer ================================= -->
 		<div class="fineprint" style="clear:both">
 			
-						The acutal function this spy stubs.
+			Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a> 2.1.0 on Tue Oct 27 2009 13:32:51 GMT-0700 (PDT)
 		</div>
 	</body>
 </html>