doc

libs/main/system/piprocess.h

@@ -36,34 +36,94 @@ class PIP_EXPORT PIProcess: public PIThread
 {
 	PIOBJECT_SUBCLASS(PIProcess, PIThread)
 public:
+
+	//! \~english Construct empty %PIProcess
+	//! \~russian Создает пустой %PIProcess
 	PIProcess();
+
 	virtual ~PIProcess();
 
+
+	//! \~english Returns last attached execution exit code
+	//! \~russian
 	int exitCode() const {return exit_code;}
+
+	//! \~english Returns current attached execution process ID
+	//! \~russian
 	int pID() const;
 
 	void setGrabInput(bool yes) {g_in = yes;}
+
+	//! \~english Set attached execution grab output stream enabled
+	//! \~russian
 	void setGrabOutput(bool yes) {g_out = yes;}
+
+	//! \~english Set attached execution grab error stream enabled
+	//! \~russian
 	void setGrabError(bool yes) {g_err = yes;}
+
 	void setInputFile(const PIString & path) {f_in.setPath(path);}
+
+	//! \~english Set attached execution grab output stream file
+	//! \~russian
 	void setOutputFile(const PIString & path) {f_out.setPath(path);}
+
+	//! \~english Set attached execution grab error stream file
+	//! \~russian
 	void setErrorFile(const PIString & path) {f_err.setPath(path);}
+
 	void unsetInputFile() {f_in.setPath("");}
+
+	//! \~english Reset attached execution grab output stream file
+	//! \~russian
 	void unsetOutputFile() {f_out.setPath("");}
+
+	//! \~english Reset attached execution grab error stream file
+	//! \~russian
 	void unsetErrorFile() {f_err.setPath("");}
+
+	//! \~english Returns current attached execution working directory or empty string if it wasn`t set
+	//! \~russian
 	PIString workingDirectory() const {return wd;}
+
+	//! \~english Set attached execution working directory
+	//! \~russian
 	void setWorkingDirectory(const PIString & path) {wd = path;}
+
+	//! \~english Rseet attached execution working directory, application working dir will be used
+	//! \~russian
 	void resetWorkingDirectory() {wd.clear();}
+
+	//! \~english Returns all attached execution output stream
+	//! \~russian
 	PIByteArray readOutput() {f_out.open(PIIODevice::ReadOnly); return f_out.readAll();}
+
+	//! \~english Returns all attached execution error stream
+	//! \~russian
 	PIByteArray readError() {f_err.open(PIIODevice::ReadOnly); return f_err.readAll();}
 
+
+	//! \~english Returns current attached execution environment
+	//! \~russian
 	PIStringList environment() {return env;}
+
+	//! \~english Clear current attached execution environment. Call before \a exec()
+	//! \~russian
 	void clearEnvironment() {env.clear();}
+
+	//! \~english Remove variable "variable" from current attached execution environment. Call before \a exec()
+	//! \~russian
 	void removeEnvironmentVariable(const PIString & variable);
+
+	//! \~english Set variable "variable" to "value" in current attached execution environment. Call before \a exec()
+	//! \~russian
 	void setEnvironmentVariable(const PIString & variable, const PIString & value);
 
-	EVENT_HANDLER1(void, exec, const PIString & , program) {args.clear(); args << program; exec_();}
+	//! \~english Start attached execution "program" with one argument "arg"
+	//! \~russian
 	void exec(const PIString & program, const PIString & arg) {args.clear(); args << program << arg; exec_();}
+
+	EVENT_HANDLER1(void, exec, const PIString & , program) {args.clear(); args << program; exec_();}
 	EVENT_HANDLER2(void, exec, const PIString & , program, const PIStringList & , args_) {args.clear(); args << program << args_; exec_();}
 	EVENT_HANDLER(void, terminate);
 	EVENT_HANDLER(bool, waitForFinish) {return waitForFinish(60000);}
@@ -72,14 +132,69 @@ public:
 	EVENT1(execStarted, PIString, program)
 	EVENT2(execFinished, PIString, program, int, exit_code)
 
-	static void execIndependent(const PIString & program) {execIndependent(program, PIStringList());}
-	static void execIndependent(const PIString & program, const PIString & arg) {execIndependent(program, PIStringList() << arg);}
-	static void execIndependent(const PIString & program, const PIStringList & args_);
 
+	//! \~english Start detached execution "program" without arguments
+	//! \~russian
+	static void execIndependent(const PIString & program) {execIndependent(program, PIStringList());}
+
+	//! \~english Start detached execution "program" with one argument "arg"
+	//! \~russian
+	static void execIndependent(const PIString & program, const PIString & arg) {execIndependent(program, PIStringList() << arg);}
+
+	//! \~english Start detached execution "program" with arguments "args"
+	//! \~russian
+	static void execIndependent(const PIString & program, const PIStringList & args);
+
+
+	//! \~english Returns application environment
+	//! \~russian
 	static PIStringList currentEnvironment();
+
+	//! \~english Returns application process ID
+	//! \~russian
 	static int currentPID();
+
+	//! \~english Returns variable "variable" value from application environment
+	//! \~russian
 	static PIString getEnvironmentVariable(const PIString & variable);
 
+//! \handlers
+//! \{
+
+	//! \fn void exec(const PIString & program)
+	//! \~english Start attached execution "program" without arguments
+	//! \~russian
+
+	//! \fn void exec(const PIString & program, const PIStringList & args)
+	//! \~english Start attached execution "program" with arguments "args"
+	//! \~russian
+
+	//! \fn void terminate()
+	//! \~english Immediately terminate attached execution
+	//! \~russian
+
+	//! \fn bool waitForFinish()
+	//! \~english Wait for attached execution finish maximum for 60 seconds
+	//! \~russian
+
+	//! \fn bool waitForFinish(int timeout_msecs)
+	//! \~english Wait for attached execution finish maximum for "timeout_msecs" milliseconds
+	//! \~russian
+
+//! \}
+//! \events
+//! \{
+
+	//! \fn void execStarted(PIString program)
+	//! \~english Raise on attached execution start
+	//! \~russian
+
+	//! \fn void execFinished(PIString program)
+	//! \~english Raise on attached execution finish
+	//! \~russian
+
+//! \}
+
 private:
 	virtual void run();
 	void exec_();