0
@@ -1645,7 +1645,7 @@ Contains methods related to the compiling code.
0
 <h3>Slot Index</h3>
0
 <div class=slotIndex>
0
 <a href="#Compiler-messageForString">messageForString()</a><br>
0
-<a href="#Compiler-messageForString2">messageForString2</a><br>
0
+<a href="#Compiler-messageForString2">messageForString2()</a><br>
0
 <a href="#Compiler-messageForTokens">messageForTokens()</a><br>
0
 <a href="#Compiler-tokensForString">tokensForString()</a><br>
0
 </div>
0
@@ -1656,9 +1656,9 @@ Contains methods related to the compiling code.
0
 <div class=slotDescription>
0
 Returns the compiled message object for aString.
0
 </div>
0
-<a name="Compiler-messageForString2"></a><b>messageForString2</b><p>
0
+<a name="Compiler-messageForString2"></a><b>messageForString2(aString)</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns the compiled message object for aString. (Runs raw string against lexer directly.)
0
 </div>
0
 <a name="Compiler-messageForTokens"></a><b>messageForTokens(aList)</b><p>
0
 <div class=slotDescription>
0
@@ -1738,19 +1738,19 @@ Object wrapper for an Io coroutine.
0
 <p>
0
 <a name="Coroutine-backTraceString"></a><b>backTraceString</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns a formatted callStack output along with exception info (if any). In case of CGI script, wraps output with &lt;code&gt; tag.
0
 </div>
0
 <a name="Coroutine-callStack"></a><b>callStack</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns a list of Call objects.
0
 </div>
0
 <a name="Coroutine-currentCoroutine"></a><b>currentCoroutine</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns currently running coroutine in Io state.
0
 </div>
0
 <a name="Coroutine-debugWriteln"></a><b>debugWriteln</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+(See <tt>Object debugWriteln</tt>.)
0
 </div>
0
 <a name="Coroutine-exception"></a><b>exception</b><p>
0
 <div class=slotDescription>
0
@@ -1758,15 +1758,15 @@ Returns the current exception or nil if there is none.
0
 </div>
0
 <a name="Coroutine-freeStack"></a><b>freeStack</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Frees all the internal data from the receiver's stack. Returns self.
0
 </div>
0
 <a name="Coroutine-ignoredCoroutineMethodNames"></a><b>ignoredCoroutineMethodNames</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+List of methods to ignore when building a <tt>callStack</tt>.
0
 </div>
0
 <a name="Coroutine-implementation"></a><b>implementation</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns coroutine implementation type: "fibers", "ucontext" or "setjmp"
0
 </div>
0
 <a name="Coroutine-inException"></a><b>inException</b><p>
0
 <div class=slotDescription>
0
@@ -1778,7 +1778,7 @@ Returns List of values on this coroutine's stack.
0
 </div>
0
 <a name="Coroutine-isCurrent"></a><b>isCurrent</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns true if the receiver is currently running coroutine.
0
 </div>
0
 <a name="Coroutine-isYielding"></a><b>isYielding</b><p>
0
 <div class=slotDescription>
0
@@ -1790,7 +1790,7 @@ A label slot useful for debugging purposes.
0
 </div>
0
 <a name="Coroutine-main"></a><b>main</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+[Seems to be obsolete!] Executes runMessage, resumes parent coroutine.
0
 </div>
0
 <a name="Coroutine-parentCoroutine"></a><b>parentCoroutine</b><p>
0
 <div class=slotDescription>
0
@@ -1803,11 +1803,11 @@ Removes current coroutine from the yieldingCoros queue and
0
 </div>
0
 <a name="Coroutine-pauseCurrentAndResumeSelf"></a><b>pauseCurrentAndResumeSelf</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Pauses current coroutine and yields to a receiver.
0
 </div>
0
 <a name="Coroutine-raiseException"></a><b>raiseException</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Sets exception in the receiver and resumes parent coroutine.
0
 </div>
0
 <a name="Coroutine-result"></a><b>result</b><p>
0
 <div class=slotDescription>
0
@@ -1815,7 +1815,8 @@ The result set when the coroutine ends.
0
 </div>
0
 <a name="Coroutine-resume"></a><b>resume</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Yields to the receiver. Runs the receiver if it is not running yet. 
0
+  Returns self.
0
 </div>
0
 <a name="Coroutine-resumeLater"></a><b>resumeLater</b><p>
0
 <div class=slotDescription>
0
@@ -1824,11 +1825,11 @@ Promotes receiver to the top of the yieldingCoros queue, but not yielding to it.
0
 </div>
0
 <a name="Coroutine-resumeParentCoroutine"></a><b>resumeParentCoroutine</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Pauses current coroutine and resumes parent.
0
 </div>
0
 <a name="Coroutine-run"></a><b>run</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Runs receiver and returns self.
0
 </div>
0
 <a name="Coroutine-runLocals"></a><b>runLocals</b><p>
0
 <div class=slotDescription>
0
@@ -1844,15 +1845,15 @@ The object which the coroutine will send a message to when it starts.
0
 </div>
0
 <a name="Coroutine-setException"></a><b>setException</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setInException"></a><b>setInException</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setLabel"></a><b>setLabel</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setMessageDebugging"></a><b>setMessageDebugging(aBoolean)</b><p>
0
 <div class=slotDescription>
0
@@ -1863,31 +1864,31 @@ for more information.
0
 </div>
0
 <a name="Coroutine-setParentCoroutine"></a><b>setParentCoroutine</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setResult"></a><b>setResult</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setRunLocals"></a><b>setRunLocals</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setRunMessage"></a><b>setRunMessage</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setRunTarget"></a><b>setRunTarget</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setStackSize"></a><b>setStackSize</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-setYieldingCoros"></a><b>setYieldingCoros</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+
0
 </div>
0
 <a name="Coroutine-showStack"></a><b>showStack</b><p>
0
 <div class=slotDescription>
0
@@ -1895,7 +1896,7 @@ Writes backTraceString to STDOUT.
0
 </div>
0
 <a name="Coroutine-showYielding"></a><b>showYielding</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Prints a list of yielding coroutines to STDOUT.
0
 </div>
0
 <a name="Coroutine-stackSize"></a><b>stackSize</b><p>
0
 <div class=slotDescription>
0
@@ -1903,7 +1904,7 @@ Stack size allocated for each new coroutine. Coroutines will automatically chain
0
 </div>
0
 <a name="Coroutine-typeId"></a><b>typeId</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns <type>_<uniqueHexId> string.
0
 </div>
0
 <a name="Coroutine-yield"></a><b>yield</b><p>
0
 <div class=slotDescription>
0
@@ -1912,7 +1913,7 @@ Yields to another coroutine in the yieldingCoros queue.
0
 </div>
0
 <a name="Coroutine-yieldCurrentAndResumeSelf"></a><b>yieldCurrentAndResumeSelf</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Yields to a receiver.
0
 </div>
0
 <a name="Coroutine-yieldingCoros"></a><b>yieldingCoros</b><p>
0
 <div class=slotDescription>
0
@@ -9010,7 +9011,7 @@ Returns one-line string representation up to 40 characters long.
0
 </div>
0
 <a name="Message-asStackEntry"></a><b>asStackEntry</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns a string containing message name, file and line.
0
 </div>
0
 <a name="Message-asString"></a><b>asString</b><p>
0
 <div class=slotDescription>
0
@@ -17273,7 +17274,7 @@ Returns the path of io installation. The default is $INSTALL_PREFIX/lib/io.
0
 </div>
0
 <a name="System-launchPath"></a><b>launchPath</b><p>
0
 <div class=slotDescription>
0
-<div class=error>undocumented</div>
0
+Returns a pathComponent of the launch file.
0
 </div>
0
 <a name="System-launchScript"></a><b>launchScript</b><p>
0
 <div class=slotDescription>
0
@@ -18768,12 +18769,14 @@ nil is a singleton object that is used as a placeholder and to mean false in Io.
0
 <h3>Slot Index</h3>
0
 <div class=slotIndex>
0
 <a href="#nil-and">and()</a><br>
0
+<a href="#nil-catch">catch</a><br>
0
 <a href="#nil-clone">clone</a><br>
0
 <a href="#nil-else">else()</a><br>
0
 <a href="#nil-ifNil">ifNil()</a><br>
0
 <a href="#nil-isNil">isNil</a><br>
0
 <a href="#nil-justSerialized">justSerialized()</a><br>
0
 <a href="#nil-or">or()</a><br>
0
+<a href="#nil-pass">pass</a><br>
0
 <a href="#nil-print">print</a><br>
0
 <a href="#nil-then">then()</a><br>
0
 </div>
0
@@ -18784,6 +18787,10 @@ nil is a singleton object that is used as a placeholder and to mean false in Io.
0
 <div class=slotDescription>
0
 Returns nil without evaluating expression.
0
 </div>
0
+<a name="nil-catch"></a><b>catch</b><p>
0
+<div class=slotDescription>
0
+Does nothing, returns nil. See <tt>Exception catch</tt>.
0
+</div>
0
 <a name="nil-clone"></a><b>clone</b><p>
0
 <div class=slotDescription>
0
 returns self since nil is a singleton.
0
@@ -18808,6 +18815,10 @@ Writes the receiver's code into the stream.
0
 <div class=slotDescription>
0
 Returns anObject if anObject is not nil. Otherwise returns nil.
0
 </div>
0
+<a name="nil-pass"></a><b>pass</b><p>
0
+<div class=slotDescription>
0
+Does nothing, returns nil. See <tt>Exception pass</tt>.
0
+</div>
0
 <a name="nil-print"></a><b>print</b><p>
0
 <div class=slotDescription>
0
 Prints 'nil'. Returns self.

0
@@ -337,7 +337,7 @@ Object do(
0
   )
0
 
0
   //doc Object launchFile(pathString) Eval file at pathString as if from the command line in it's folder.
0
-
0
+  //doc System launchPath Returns a pathComponent of the launch file.
0
   launchFile := method(path, args,
0
     args ifNil(args = List clone)
0
     System launchPath :=  path pathComponent

0
@@ -60,39 +60,51 @@ Scheduler := Object clone do(
0
 
0
 Coroutine do(
0
   //doc Coroutine stackSize Stack size allocated for each new coroutine. Coroutines will automatically chain themselves as need if more stack space is required.
0
+	//doc Coroutine setStackSize
0
   stackSize ::= 128000 // PPC needs 128k for current parser
0
   
0
   //doc Coroutine exception Returns the current exception or nil if there is none.
0
+	//doc Coroutine setException
0
   exception ::= nil
0
   
0
   //doc Coroutine parentCoroutine Returns the parent coroutine this one was chained from or nil if it wasn't chained. When a Coroutine ends, it will attempt to resume it's parent.
0
+	//doc Coroutine setParentCoroutine
0
   parentCoroutine ::= nil
0
   
0
   //doc Coroutine runTarget The object which the coroutine will send a message to when it starts.
0
+	//doc Coroutine setRunTarget
0
   runTarget ::= nil
0
 
0
   //doc Coroutine runLocals The locals object in whose context the coroutine will send it's run message.
0
+	//doc Coroutine setRunLocals
0
   runLocals ::= nil
0
 
0
   //doc Coroutine runMessage The message to send to the runTarget when the coroutine starts.
0
+	//doc Coroutine setRunMessage
0
   runMessage ::= nil
0
 
0
   //doc Coroutine result The result set when the coroutine ends.
0
+	//doc Coroutine setResult 
0
   result ::= nil
0
   
0
   //doc Coroutine label A label slot useful for debugging purposes.
0
+	//doc Coroutine setLabel
0
   label ::= ""
0
 
0
   //doc Coroutine inException Set to true when processing an exception in the coroutine.
0
+	//doc Coroutine setInException
0
   inException ::= false
0
   
0
   //doc Coroutine yieldingCoros Reference to Scheduler yieldingCoros.
0
+	//doc Coroutine setYieldingCoros
0
   yieldingCoros ::= Scheduler yieldingCoros
0
+	//doc Coroutine debugWriteln (See <tt>Object debugWriteln</tt>.)
0
   debugWriteln := nil
0
 
0
   label := method(self uniqueId)
0
   setLabel := method(s, self label = s .. "_" .. self uniqueId)
0
-
0
+  
0
+  //doc Coroutine showYielding Prints a list of yielding coroutines to STDOUT.
0
   showYielding := method(s,
0
     writeln("   ", label, " ", s)
0
     yieldingCoros foreach(v, writeln("    ", v uniqueId))
0
@@ -147,22 +159,27 @@ Coroutine do(
0
   )
0
 
0
   //FIXME: these two methods are identical!!
0
+  //doc Coroutine yieldCurrentAndResumeSelf Yields to a receiver.
0
   yieldCurrentAndResumeSelf := method(
0
     //showYielding("yieldCurrentAndResumeSelf")
0
     yieldingCoros remove(self)
0
     isCurrent ifFalse(resume)
0
   )
0
-
0
+  //FIXME: these two methods are identical!!
0
+  //doc Coroutine pauseCurrentAndResumeSelf Pauses current coroutine and yields to a receiver.
0
   pauseCurrentAndResumeSelf := method(
0
     //showYielding("pauseCurrentAndResumeSelf")
0
     yieldingCoros remove(self)
0
     isCurrent ifFalse(resume)
0
   )
0
-
0
+  
0
+  //doc Coroutine typeId Returns <type>_<uniqueHexId> string.
0
   typeId := method(self type .. "_0x" .. self uniqueId asString toBase(16))
0
-
0
+    
0
+  //doc Coroutine ignoredCoroutineMethodNames List of methods to ignore when building a <tt>callStack</tt>.
0
   ignoredCoroutineMethodNames := list("setResult", "main", "pauseCurrentAndResumeSelf", "resumeParentCoroutine", "raiseException")
0
 
0
+  //doc Coroutine callStack Returns a list of Call objects.
0
   callStack := method(
0
     stack := ioStack
0
     stack selectInPlace(v, Object argIsCall(getSlot("v"))) reverseInPlace
0
@@ -174,6 +191,7 @@ Coroutine do(
0
     stack
0
   )
0
 
0
+  //doc Coroutine backTraceString Returns a formatted callStack output along with exception info (if any). In case of CGI script, wraps output with &lt;code&gt; tag.
0
   backTraceString := method(
0
     if(Coroutine inException,
0
       writeln("\n", exception type, ": ", exception error, "\n\n")
0
@@ -222,21 +240,22 @@ Coroutine do(
0
     buf
0
   )
0
 
0
-  /*doc Coroutine showStack
0
-  Writes backTraceString to STDOUT.
0
-  */
0
+  //doc Coroutine showStack Writes backTraceString to STDOUT.
0
   showStack := method(write(backTraceString))
0
-
0
+    
0
+  //doc Coroutine resumeParentCoroutine Pauses current coroutine and resumes parent.
0
   resumeParentCoroutine := method(
0
     if(parentCoroutine, parentCoroutine pauseCurrentAndResumeSelf)
0
   )
0
-
0
+  
0
+  //doc Coroutine main [Seems to be obsolete!] Executes runMessage, resumes parent coroutine.
0
   main := method(
0
     setResult(self getSlot("runTarget") doMessage(runMessage, self getSlot("runLocals")))
0
     resumeParentCoroutine
0
     pause
0
   )
0
-
0
+  
0
+  //doc Coroutine raiseException Sets exception in the receiver and resumes parent coroutine.
0
   raiseException := method(e,
0
     self setException(e)
0
     resumeParentCoroutine
0
@@ -264,6 +283,7 @@ Message do(
0
     if (c size < length, c, c slice(0, length) .. "...") asMutable replaceSeq("\n", ";")
0
   )
0
 
0
+  //doc Message asStackEntry Returns a string containing message name, file and line.
0
   asStackEntry := method(
0
     label := label lastPathComponent fileName
0
     label alignLeft(19) .. lineNumber asString alignLeft(7) .. name
0
@@ -343,6 +363,8 @@ Object do(
0
 )
0
 
0
 nil do(
0
+  //doc nil catch Does nothing, returns nil. See <tt>Exception catch</tt>.
0
+	//doc nil pass Does nothing, returns nil. See <tt>Exception pass</tt>.
0
   catch := nil
0
   pass := nil
0
 )

0
@@ -105,6 +105,9 @@ IoObject *IoObject_messageForString(IoObject *self, IoObject *locals, IoMessage
0
 
0
 IoObject *IoObject_messageForString2(IoObject *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Compiler messageForString2(aString)
0
+	Returns the compiled message object for aString. (Runs raw string against lexer directly.)
0
+	*/
0
   IoLexer *lexer = IoLexer_new();
0
   char *text = IoMessage_locals_cStringArgAt_(m, locals, 0);
0
   IoMessage *msg;

0
@@ -286,6 +286,9 @@ void IoCoroutine_coroStartWithContextAndCFunction(void *context, CoroStartCallba
0
 
0
 IoObject *IoCoroutine_freeStack(IoCoroutine *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Coroutine freeStack
0
+  Frees all the internal data from the receiver's stack. Returns self.
0
+  */
0
   IoCoroutine *current = IoState_currentCoroutine(IOSTATE);
0
 
0
   if (current != self && DATA(self)->cid)
0
@@ -354,6 +357,9 @@ void IoCoroutine_rawRun(IoCoroutine *self)
0
 
0
 IoObject *IoCoroutine_run(IoCoroutine *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Coroutine run
0
+  Runs receiver and returns self.
0
+  */
0
   IoCoroutine_rawRun(self);
0
   return IoCoroutine_rawResult(self);
0
 }
0
@@ -418,23 +424,36 @@ IoObject *IoCoroutine_rawResume(IoCoroutine *self)
0
 
0
 IoObject *IoCoroutine_resume(IoCoroutine *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Coroutine resume
0
+  Yields to the receiver. Runs the receiver if it is not running yet. 
0
+  Returns self.
0
+  */
0
   //printf("IoCoroutine_resume()\n");
0
   return IoCoroutine_rawResume(self);
0
 }
0
 
0
 IoObject *IoCoroutine_implementation(IoCoroutine *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Coroutine implementation
0
+  Returns coroutine implementation type: "fibers", "ucontext" or "setjmp"
0
+  */
0
   return IOSYMBOL(CORO_IMPLEMENTATION);
0
 }
0
 
0
 IoObject *IoCoroutine_isCurrent(IoCoroutine *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Coroutine isCurrent 
0
+  Returns true if the receiver is currently running coroutine.
0
+  */
0
   IoObject *v = IOBOOL(self, self == IoState_currentCoroutine(IOSTATE));
0
   return v;
0
 }
0
 
0
 IoObject *IoCoroutine_currentCoroutine(IoCoroutine *self, IoObject *locals, IoMessage *m)
0
 {
0
+  /*doc Coroutine currentCoroutine
0
+  Returns currently running coroutine in Io state.
0
+  */
0
   return IoState_currentCoroutine(IOSTATE);
0
 }
0