Update to NSPR 4.10.2.

nspr/pr/include/prthread.h

 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
 /* This Source Code Form is subject to the terms of the Mozilla Public
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
 
 #ifndef prthread_h___
 #define prthread_h___
 
 /*
 ** API for NSPR threads. On some architectures (Mac OS Classic
@@ skipping 123 matching lines @@
 #define PR_CurrentThread() PR_GetCurrentThread() /* for nspr1.0 compat. */
 #endif /* NO_NSPR_10_SUPPORT */
 
 /*
 ** Get the priority of "thread".
 */
 NSPR_API(PRThreadPriority) PR_GetThreadPriority(const PRThread *thread);
 
 /*
 ** Change the priority of the "thread" to "priority".
+**
+** PR_SetThreadPriority works in a best-effort manner. On some platforms a
+** special privilege, such as root access, is required to change thread
+** priorities, especially to raise thread priorities. If the caller doesn't
+** have enough privileges to change thread priorites, the function has no
+** effect except causing a future PR_GetThreadPriority call to return
+** |priority|.
 */
 NSPR_API(void) PR_SetThreadPriority(PRThread *thread, PRThreadPriority priority);
 
 /*
 ** Set the name of the current thread, which will be visible in a debugger
 ** and accessible via a call to PR_GetThreadName().
 */
 NSPR_API(PRStatus) PR_SetCurrentThreadName(const char *name);
 
 /*
@@ skipping 102 matching lines @@
 NSPR_API(PRThreadType) PR_GetThreadType(const PRThread *thread);
 
 /*
 ** Get the join state of this thread.
 */
 NSPR_API(PRThreadState) PR_GetThreadState(const PRThread *thread);
 
 PR_END_EXTERN_C
 
 #endif /* prthread_h___ */