From a08fa2cdb905d6912b37aea390a831bbb46c3863 Mon Sep 17 00:00:00 2001
From: Kenneth Schwartz <irchtml@php.net>
Date: Wed, 25 Feb 2004 17:36:15 +0000
Subject: [PATCH] finished up get/setpriority docs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@152372 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../pcntl/functions/pcntl-getpriority.xml     | 17 +++++++++++----
 .../pcntl/functions/pcntl-setpriority.xml     | 21 +++++++++++++++----
 2 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/reference/pcntl/functions/pcntl-getpriority.xml b/reference/pcntl/functions/pcntl-getpriority.xml
index 78c886831a..a023b144c1 100644
--- a/reference/pcntl/functions/pcntl-getpriority.xml
+++ b/reference/pcntl/functions/pcntl-getpriority.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id='function.pcntl-getpriority'>
    <refnamediv>
     <refname>pcntl_getpriority</refname>
@@ -12,11 +12,20 @@
      <methodsynopsis>
       <type>int</type><methodname>pcntl_getpriority</methodname>
       <methodparam choice="opt"><type>int</type><parameter>pid</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>process_identifier</parameter></methodparam>
      </methodsynopsis>
     <para>
-     &warn.undocumented.func;
+     <function>pcntl_getpriority</function> gets the priority of 
+     <parameter>pid</parameter>.  If <parameter>pid</parameter> is not
+     specified, the pid of the current process is used.  Because priority
+     levels can differ between system types and kernel versions, please see
+     your system's getpriority(2) man page for specific details.
     </para>
+    <para>
+     <function>pcntl_getpriority</function> returns the priority of the process
+     or &false; on error.  A lower numerical value causes more favorable
+     scheduling.
+    </para>
+    &return.falseproblem;
    </refsect1>
   </refentry>
 
@@ -39,4 +48,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file
diff --git a/reference/pcntl/functions/pcntl-setpriority.xml b/reference/pcntl/functions/pcntl-setpriority.xml
index 56982f0fda..2072613be9 100644
--- a/reference/pcntl/functions/pcntl-setpriority.xml
+++ b/reference/pcntl/functions/pcntl-setpriority.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
   <refentry id='function.pcntl-setpriority'>
    <refnamediv>
     <refname>pcntl_setpriority</refname>
@@ -13,10 +13,23 @@
       <type>bool</type><methodname>pcntl_setpriority</methodname>
       <methodparam><type>int</type><parameter>priority</parameter></methodparam>
       <methodparam choice="opt"><type>int</type><parameter>pid</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>process_identifier</parameter></methodparam>
      </methodsynopsis>
     <para>
-     &warn.undocumented.func;
+     <function>pcntl_setpriority</function> sets the priority of
+     <parameter>pid</parameter> to <parameter>priority</parameter>.  If
+     <parameter>pid</parameter> is not specified, the pid of the current
+     process is used.
+    </para>
+    <para>
+     <parameter>priority</parameter> is generally a value in the range
+     <literal>-20</literal> to <literal>20</literal>. The default priority
+     is <literal>0</literal> while a lower numerical value causes more
+     favorable scheduling.  Because priority levels can differ between
+     system types and kernel versions, please see your system's setpriority(2)
+     man page for specific details.
+    </para>
+    <para>
+     &return.success;
     </para>
    </refsect1>
   </refentry>
@@ -40,4 +53,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->
\ No newline at end of file