Improvements to the "Process" extension.

- Make waitForFinished() return true also if the process is not running
at the time the function is called.
- Make exec() return -1 for a non-normal exit status;
QProcess::exitCode() is not guaranteed to return a non-zero value in
such a case.
- Introduce terminate() and kill() functions.

Change-Id: I130f6e31579c2e316a3534cd738deee848363a1d
Reviewed-by: Joerg Bornemann <joerg.bornemann@digia.com>

1 files changed, 13 insertions, 0 deletions

diff --git a/doc/reference/jsextensions/jsextension-process.qdoc b/doc/reference/jsextensions/jsextension-process.qdoc
index 65d96d1aa..2bd0a4101 100644
--- a/doc/reference/jsextensions/jsextension-process.qdoc
+++ b/doc/reference/jsextensions/jsextension-process.qdoc
@@ -82,6 +82,12 @@
     \endcode
     Returns the value of the variable \c varName in the process' environment.
 
+    \section2 kill
+    \code
+    kill()
+    \endcode
+    Kills the process, causing it to exit immediately.
+
     \section2 readLine
     \code
     readLine()
@@ -117,6 +123,13 @@
     to interact with the process while it is running. Most of the time, you want to use \c exec()
     instead.
 
+    \section2 terminate
+    \code
+    terminate()
+    \endcode
+    Tries to terminate the process. This is not guaranteed to make the process exit immediately;
+    if you need that, use \c kill().
+
     \section2 waitForFinished
     \code
     waitForFinished(timeout)