1 files changed, 5 insertions, 3 deletions
diff --git a/thread.c b/thread.c
index ff0df2be58..b674577676 100644
--- a/thread.c
+++ b/thread.c
@@ -2174,15 +2174,17 @@ rb_thread_exit(void)
  *  call-seq:
  *     thr.wakeup   -> thr
  *
- *  Marks <i>thr</i> as eligible for scheduling (it may still remain blocked on
- *  I/O, however). Does not invoke the scheduler (see <code>Thread#run</code>).
+ *  Marks a given thread as eligible for scheduling, however it may still
+ *  remain blocked on I/O.
+ *
+ *  *Note:* This does not invoke the scheduler, see #run for more information.
  *
  *     c = Thread.new { Thread.stop; puts "hey!" }
  *     sleep 0.1 while c.status!='sleep'
  *     c.wakeup
  *     c.join
  *
- *  <em>produces:</em>
+ *  _produces:_
  *
  *     hey!
  */