Minor doc fix

doc/symbols/_global_.html

@@ -384,7 +384,9 @@ ul.inheritsList
 					
 					</div>
 					<div class="description">
-						A function that is called after each spec in a suite.
+						A function that is called after each spec in a suite.
+
+Used for restoring any state that is hijacked during spec execution.
 						
 							<br />
 							<i>Defined in: </i> <a href="../symbols/src/lib_jasmine-0.10.0.js.html">jasmine-0.10.0.js</a>.
@@ -423,7 +425,9 @@ ul.inheritsList
 					
 					</div>
 					<div class="description">
-					</div>
+						A function that is called before each spec in a suite.
+
+Used for spec setup, including validating assumptions.
 						
 							<br />
 							<i>Defined in: </i> <a href="../symbols/src/lib_jasmine-0.10.0.js.html">jasmine-0.10.0.js</a>.
@@ -462,7 +466,11 @@ ul.inheritsList
 					
 					</div>
 					<div class="description">
-					<b>describe</b>(description, specDefinitions)
+						Defines a suite of specifications.
+
+Stores the description and all defined specs in the Jasmine environment as one suite of specs. Variables declared
+are accessible by calls to beforeEach, it, and afterEach. Describe blocks can be nested, allowing for specialization
+of setup in some tests.
 						
 							<br />
 							<i>Defined in: </i> <a href="../symbols/src/lib_jasmine-0.10.0.js.html">jasmine-0.10.0.js</a>.
@@ -472,7 +480,9 @@ ul.inheritsList
 					
 					
 					
-							<br />
+					<pre class="code">// TODO: a simple suite
+
+// TODO: a simple suite with a nested describe block</pre>
 					
 					
 					
@@ -511,7 +521,10 @@ ul.inheritsList
 					
 					</div>
 					<div class="description">
-					<hr />
+						Starts a chain for a Jasmine expectation.
+
+It is passed an Object that is the actual value and should chain to one of the many
+jasmine.Matchers functions.
 						
 							<br />
 							<i>Defined in: </i> <a href="../symbols/src/lib_jasmine-0.10.0.js.html">jasmine-0.10.0.js</a>.
@@ -550,7 +563,9 @@ ul.inheritsList
 					
 					</div>
 					<div class="description">
-						
+						Creates a Jasmine spec that will be added to the current suite.
+
+// TODO: pending tests
 						
 							<br />
 							<i>Defined in: </i> <a href="../symbols/src/lib_jasmine-0.10.0.js.html">jasmine-0.10.0.js</a>.
@@ -560,7 +575,9 @@ ul.inheritsList
 					
 					
 					
-					
+					<pre class="code">it('should be true', function() {
+  expect(true).toEqual(true);
+});</pre>
 					
 					
 					
@@ -648,7 +665,11 @@ ul.inheritsList
 					
 					
 					
-					<div class="fixedFont">
+					<pre class="code">// spy example
+var foo = {
+  not: function(bool) { return !bool; }
+}
+spyOn(foo, 'not'); // actual foo.not will not be called, execution stops</pre>
 					
 					
 					
@@ -836,7 +857,9 @@ ul.inheritsList
 					
 					</div>
 					<div class="description">
-								<dd>function that defines several specs.</dd>
+						Creates a <em>disabled</em> Jasmine spec.
+
+A convenience method that allows existing specs to be disabled temporarily during development.
 						
 							<br />
 							<i>Defined in: </i> <a href="../symbols/src/lib_jasmine-0.10.0.js.html">jasmine-0.10.0.js</a>.
@@ -885,7 +908,7 @@ ul.inheritsList
 <!-- ============================== footer ================================= -->
 		<div class="fineprint" style="clear:both">
 			
-							</dl>
+			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>