diff --git a/reference/exec/functions/proc-nice.xml b/reference/exec/functions/proc-nice.xml
index 700e683a22..8c204c3277 100644
--- a/reference/exec/functions/proc-nice.xml
+++ b/reference/exec/functions/proc-nice.xml
@@ -33,8 +33,65 @@
increment
- The increment value of the priority change.
+ The new priority value, the value of this may differ on platforms.
+
+ on Unix, a low value, such as -20 means high priority
+ wheras a positive value have a lower priority.
+
+
+ For Windows the increment parameter have the
+ following meanings:
+
+
+
+
+
+ Priority class
+ Possible values
+
+
+
+
+ REALTIME_PRIORITY_CLASS
+
+ increment > 23
+
+
+
+ HIGH_PRIORITY_CLASS
+
+ increment > 12
+
+
+
+ ABOVE_NORMAL_PRIORITY_CLASS
+
+ increment > 9
+
+
+
+ NORMAL_PRIORITY_CLASS
+
+ increment > 7 &
+ increment < 4
+
+
+
+ IDLE_PRIORITY_CLASS
+
+ increment > 5
+
+
+
+ BELOW_NORMAL_PRIORITY_CLASS
+
+ increment > 3
+
+
+
+
+
@@ -50,6 +107,64 @@
+
+ &reftitle.examples;
+
+
+ Using <function>proc_open</function> to set the process priority to high
+
+
+]]>
+
+ &example.outputs.similar;
+
+ aeiou
+ [PWD] => /tmp
+ [SHLVL] => 1
+ [_] => /usr/local/bin/php
+)
+command returned 0
+]]>
+
+
+
+
+
+
+
+ &reftitle.changelog;
+
+
+
+
+
+ &Version;
+ &Description;
+
+
+
+
+ 7.2.0
+
+ This function is now available on Windows.
+
+
+
+
+
+
+
+
&reftitle.notes;
@@ -57,8 +172,18 @@
proc_nice will only exist if your system has 'nice'
capabilities. 'nice' conforms to: SVr4, SVID EXT, AT&T, X/OPEN, BSD
- 4.3. This means that proc_nice is not available
- on Windows.
+ 4.3.
+
+
+
+ Windows only
+
+ The values of increment tries to mimic the output of
+ the wmic.
+
+
+ On Windows this function will only change the current process
+ priority, even if PHP was compiled using thread safety.