]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/process.tex
cross-reference types in the generated docs (patch 1038083)
[wxWidgets.git] / docs / latex / wx / process.tex
index e3ced7324959927c78bca80110eb43545ebc3cd9..d19b33a4b087cb1418290abd7989fb8e2cf547c0 100644 (file)
@@ -41,14 +41,14 @@ for explicit destruction.}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxProcess::wxProcess}\label{wxprocessconstr}
+\membersection{wxProcess::wxProcess}\label{wxprocessctor}
 
 \func{}{wxProcess}{\param{wxEvtHandler *}{ parent = NULL}, \param{int}{ id = -1}}
 
 \func{}{wxProcess}{\param{int }{flags}}
 
 Constructs a process object. {\it id} is only used in the case you want to
-use wxWindows events. It identifies this object, or another window that will
+use wxWidgets events. It identifies this object, or another window that will
 receive the event.
 
 If the {\it parent} parameter is different from NULL, it will receive
@@ -69,7 +69,7 @@ to calling \helpref{Redirect}{wxprocessredirect}.
 
 \docparam{flags}{either {\tt wxPROCESS\_DEFAULT} or {\tt wxPROCESS\_REDIRECT}}
 
-\membersection{wxProcess::\destruct{wxProcess}}
+\membersection{wxProcess::\destruct{wxProcess}}\label{wxprocessdtor}
 
 \func{}{\destruct{wxProcess}}{\void}
 
@@ -125,7 +125,7 @@ See \helpref{wxProcess::Redirect}{wxprocessredirect}.
 
 \constfunc{bool}{IsErrorAvailable}{\void}
 
-Returns {\tt TRUE} if there is data to be read on the child process standard
+Returns {\tt true} if there is data to be read on the child process standard
 error stream.
 
 \wxheading{See also}
@@ -136,9 +136,9 @@ error stream.
 
 \constfunc{bool}{IsInputAvailable}{\void}
 
-Returns {\tt TRUE} if there is data to be read on the child process standard
+Returns {\tt true} if there is data to be read on the child process standard
 output stream. This allows to write simple (and extremely inefficient)
-polling-based code waiting for a better mechanism in future wxWindows versions.
+polling-based code waiting for a better mechanism in future wxWidgets versions.
 
 See the \helpref{exec sample}{sampleexec} for an example of using this
 function.
@@ -151,11 +151,11 @@ function.
 
 \constfunc{bool}{IsInputOpened}{\void}
 
-Returns {\tt TRUE} if the child process standard output stream is opened.
+Returns {\tt true} if the child process standard output stream is opened.
 
 \membersection{wxProcess::Kill}\label{wxprocesskill}
 
-\func{static wxKillError}{Kill}{\param{int}{ pid}, \param{wxSignal}{ signal = wxSIGNONE}}
+\func{static wxKillError}{Kill}{\param{int}{ pid}, \param{wxSignal}{ signal = wxSIGNONE}, \param{int }{flags = wxKILL\_NOCHILDREN}}
 
 Send the specified signal to the given process. Possible signal values are:
 
@@ -185,6 +185,11 @@ enum wxSignal
 under both Unix and Windows but all the other signals are equivalent to
 {\tt wxSIGTERM} under Windows.
 
+The {\it flags} parameter can be wxKILL\_NOCHILDREN (the default),
+or wxKILL\_CHILDREN, in which case the child processes of this
+process will be killed too. Note that under Unix, for wxKILL\_CHILDREN
+to work you should have created the process passing wxEXEC\_MAKE_GROUP\_LEADER.
+
 Returns the element of {\tt wxKillError} enum:
 
 \begin{verbatim}
@@ -208,7 +213,7 @@ enum wxKillError
 
 \func{static bool}{Exists}{\param{int}{ pid}}
 
-Returns {\tt TRUE} if the given process exists in the system.
+Returns {\tt true} if the given process exists in the system.
 
 \wxheading{See also}
 
@@ -217,10 +222,10 @@ Returns {\tt TRUE} if the given process exists in the system.
 
 \membersection{wxProcess::OnTerminate}\label{wxprocessonterminate}
 
-\constfunc{void}{OnTerminate}{\param{int}{ pid}, \param{int}{ status}}
+\func{void}{OnTerminate}{\param{int}{ pid}, \param{int}{ status}}
 
 It is called when the process with the pid {\it pid} finishes.
-It raises a wxWindows event when it isn't overridden.
+It raises a wxWidgets event when it isn't overridden.
 
 \docparam{pid}{The pid of the process which has just terminated.}
 
@@ -228,7 +233,7 @@ It raises a wxWindows event when it isn't overridden.
 
 \membersection{wxProcess::Open}\label{wxprocessopen}
 
-\func{static wxProcess *}{Open}{\param{const wxString\& }{cmd} \param{int }{flags = wxEXEC\_ASYNC}}
+\func{static wxProcess *}{Open}{\param{const wxString\& }{cmd}, \param{int }{flags = wxEXEC\_ASYNC}}
 
 This static method replaces the standard {\tt popen()} function: it launches
 the process specified by the {\it cmd} parameter and returns the wxProcess