* thread.c (rb_thread_priority, rb_thread_priority_set): fix rdoc.

Lower-priority thread may run even if there are higher-priority
  threads.  See [ruby-dev:40977].

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

ChangeLog

@@ -1,3 +1,9 @@
+Thu Apr 15 22:41:47 2010  Yusuke Endoh  <mame@tsg.ne.jp>
+
+	* thread.c (rb_thread_priority, rb_thread_priority_set): fix rdoc.
+	  Lower-priority thread may run even if there are higher-priority
+	  threads.  See [ruby-dev:40977].
+
 Thu Apr 15 22:33:35 2010  Yusuke Endoh  <mame@tsg.ne.jp>
 
 	* lib/uri/ftp.rb (URI::FTP#set_path): added to correct handling of

thread.c

@@ -2142,8 +2142,11 @@ rb_thread_keys(VALUE self)
  *
  *  Returns the priority of <i>thr</i>. Default is inherited from the
  *  current thread which creating the new thread, or zero for the
- *  initial main thread; higher-priority threads will run before
- *  lower-priority threads.
+ *  initial main thread; higher-priority thread will run more frequently
+ *  than lower-priority threads (but lower-priority threads can also run).
+ *
+ *  This is just hint for Ruby thread scheduler.  It may be ignored on some
+ *  platform.
  *
  *     Thread.current.priority   #=> 0
  */
@@ -2162,7 +2165,11 @@ rb_thread_priority(VALUE thread)
  *     thr.priority= integer   => thr
  *
  *  Sets the priority of <i>thr</i> to <i>integer</i>. Higher-priority threads
- *  will run before lower-priority threads.
+ *  will run more frequently than lower-priority threads (but lower-priority
+ *  threads can also run).
+ *
+ *  This is just hint for Ruby thread scheduler.  It may be ignored on some
+ *  platform.
  *
  *     count1 = count2 = 0
  *     a = Thread.new do