Documentation updates. Fixes a few formating bugs, adds various minor missing api documentation, fixes a few typos. Also fixes a few tiny code issues, mostly missing consts, etc

darcs-hash:20060617130708-ac50b-cc2ec5aa3e4bfb8e28d7b86441bfb4661f1dd7e7.gz

parser.c

@@ -256,15 +256,29 @@ The fish parser. Contains functions for parsing code.
 */
 #define ERR_STR_SZ 1024
 
+/**
+   Datastructure to describe a block type, like while blocks, command substitution blocks, etc.
+*/
 struct block_lookup_entry
 {
+	/**
+	   The block type id. The legal values are defined in parser.h.
+	*/
 	int type;
+	/**
+	   The name of the builtin that creates this type of block, if any. 
+	*/
 	const wchar_t *name;
+	/**
+	   A description of this block type
+	*/
 	const wchar_t *desc;
 }
 	;
 
-
+/**
+   List of all legal block types
+*/
 const static struct block_lookup_entry block_lookup[]=
 {
 	{