* vm_trace.c (set_trace_func): Formatting of params and events

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@38037 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

ChangeLog

@@ -1,3 +1,7 @@
+Fri Nov 30 15:15:00 2012  Zachary Scott  <zachary@zacharyscott.net>
+
+	* vm_trace.c (set_trace_func): Formatting of params and events
+
 Fri Nov 30 14:45:00 2012  Zachary Scott  <zachary@zacharyscott.net>
 
 	* lib/net/http.rb: Net::HTTP::Patch to list of HTTP Request Classes

vm_trace.c

@@ -369,17 +369,31 @@ static void call_trace_func(rb_event_flag_t, VALUE data, VALUE self, ID id, VALU
  *     set_trace_func(nil)     -> nil
  *
  *  Establishes _proc_ as the handler for tracing, or disables
- *  tracing if the parameter is +nil+. _proc_ takes up
+ *  tracing if the parameter is +nil+.
- *  to six parameters: an event name, a filename, a line number, an
+ *
- *  object id, a binding, and the name of a class. _proc_ is
+ *  _proc_ takes up to six parameters:
- *  invoked whenever an event occurs. Events are: <code>c-call</code>
+ *
- *  (call a C-language routine), <code>c-return</code> (return from a
+ *  *	an event name
- *  C-language routine), <code>call</code> (call a Ruby method),
+ *  *	a filename
- *  <code>class</code> (start a class or module definition),
+ *  *	a line number
- *  <code>end</code> (finish a class or module definition),
+ *  *	an object id
- *  <code>line</code> (execute code on a new line), <code>raise</code>
+ *  *	a binding
- *  (raise an exception), and <code>return</code> (return from a Ruby
+ *  *	the name of a class
- *  method). Tracing is disabled within the context of _proc_.
+ *
+ *  _proc_ is invoked whenever an event occurs.
+ *
+ *  Events are:
+ *
+ *  +c-call+:: call a C-language routine
+ *  +c-return+:: return from a C-language routine
+ *  +call+:: call a Ruby method
+ *  +class+:: start a class or module definition),
+ *  +end+:: finish a class or module definition),
+ *  +line+:: execute code on a new line
+ *  +raise+:: raise an exception
+ *  +return+:: return from a Ruby method
+ *
+ *  Tracing is disabled within the context of _proc_.
  *
  *      class Test
  *	def test