System.AsyncProcess: Added System.AsyncProcess doc.

Author: mikoto2000

doc/vital/System/AsyncProcess.txt

@@ -0,0 +1,73 @@
+*vital/System/AsyncProcess.txt*	Cross platform async process executor
+
+Maintainer: mikoto2000		<mikoto2000@gmail.com>
+
+=============================================================================
+CONTENTS				*Vital.System.AsyncProcess-contents*
+
+Introduction			|Vital.System.AsyncProcess-introduction|
+Usage				|Vital.System.AsyncProcess-usage|
+Functions			|Vital.System.AsyncProcess-functions|
+
+
+=============================================================================
+INTRODUCTION				*Vital.System.AsyncProcess-introduction*
+
+|Vital.System.AsyncProcess| provides a cross-platform functions to execute
+async process.
+
+
+=============================================================================
+USAGE						*Vital.System.AsyncProcess-usage*
+>
+	" call on exit callback
+	function! s:my_exit_cb(exit_code) abort
+	  echomsg 'exit_cb status: ' .. a:exit_code
+	endfunction
+	
+	" call on out callback(called per line)
+	function! s:my_out_cb(out_msg) abort
+	  echomsg 'out_cb_bytes: ' .. a:out_msg
+	endfunction
+	
+	" call on error callback(called per line)
+	function! s:my_err_cb(err_msg) abort
+	  echomsg 'err_cb msg: ' .. a:err_msg
+	endfunction
+	
+	" execute async process
+	call s:AsyncProcess.execute(
+	      \ 'ls /',
+	      \ {
+	      \   'exit_cb': function('s:my_exit_cb'),
+	      \   'out_cb': function('s:my_out_cb'),
+	      \   'err_cb': function('s:my_err_cb'),
+	      \ }
+	      \)
+<
+
+=============================================================================
+FUNCTIONS				*Vital.System.AsyncProcess-functions*
+
+				*Vital.System.AsyncProcess.execute()*
+execute({args}[, {options}])
+	Executes a async process specified by {args} (|List| or |String|).
+
+	The following attributes are supported in {options}
+
+		"exit_cb"
+		A |function| of callback function called when the process exits.
+		The callback function has one argument, exit_code(|Number|).
+
+		"out_cb"
+		A |function| of callback function called when the process outputs
+		some data. The callback function has one argument, out_msg(|String|).
+
+		"err_cb"
+		A |function| of callback function called when the process outputs
+		some error data. The callback function has one argument, err_msg(|String|).
+
+
+=============================================================================
+vim:tw=78:fo=tcq2mM:ts=8:ft=help:norl
+