Attached are patches to embed.c and runops_cores.c
The embed.c patch also includes an attempt to clarify another comment.
(It's not obvious that the code is doing all that the comment claims, but
I didn't investigate that.)
--
Email and shopping with the feelgood factor!
55% of income to good causes. http://www.ippimail.com
Index: src/embed.c
===================================================================
--- src/embed.c (revision 25166)
+++ src/embed.c (working copy)
@@ -117,13 +117,15 @@
=item C<void Parrot_set_flag>
-Sets a flag in the interpreter specified by C<flag>, any of
-C<PARROT_BOUNDS_FLAG>, or C<PARROT_PROFILE_FLAG> to enable profiling, and
-bounds checking respectively or C<PARROT_THR_TYPE_1>, C<PARROT_THR_TYPE_2>, or
-C<PARROT_THR_TYPE_3> to disable thread communication and variable sharing,
-disable variable sharing but enable thread communication, or to enable variable
-sharing.
+Sets on any of the following flags, specified by C<flag>, in the interpreter:
+Flag Effect
+C<PARROT_BOUNDS_FLAG> enable bounds checking
+C<PARROT_PROFILE_FLAG> enable profiling,
+C<PARROT_THR_TYPE_1> disable variable sharing and thread communication
+C<PARROT_THR_TYPE_2> disable variable sharing but enable thread communication
+C<PARROT_THR_TYPE_3> enable variable sharing.
+
=cut
*/
@@ -765,7 +767,10 @@
=item C<static PMC* set_current_sub>
-RT#48260: Not yet documented!!!
+Search the fixup table for a PMC matching the argument.
+On a match, set up the appropriate context
+If no match, set up a dummy PMC entry
+In either case, return a pointer to the PMC
=cut
Index: src/runops_cores.c
===================================================================
--- src/runops_cores.c (revision 25166)
+++ src/runops_cores.c (working copy)
@@ -110,7 +110,8 @@
=item C<static opcode_t * runops_trace_core>
-RT#48260: Not yet documented!!!
+Runs the Parrot operations starting at C<pc> until there are no more
+operations, using the tracing interpreter.
=cut