From ab68ac4c0221a3cfef13d86d0ebf9fc7bad710f7 Mon Sep 17 00:00:00 2001 From: "Justin M. Keyes" Date: Wed, 14 Jan 2015 01:35:40 -0500 Subject: doc: Add one-liner job control example --- runtime/doc/job_control.txt | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'runtime') diff --git a/runtime/doc/job_control.txt b/runtime/doc/job_control.txt index 000409597f..b3a95ae7b9 100644 --- a/runtime/doc/job_control.txt +++ b/runtime/doc/job_control.txt @@ -37,6 +37,17 @@ for details ============================================================================== 2. Usage *job-control-usage* +Here's a quick one-liner that creates a job which invokes the "ls" shell +command and prints the result: +> + call jobstart('', 'ls', ['-a'])|au JobActivity * echo v:job_data|au! + JobActivity + +In the one-liner above, creating the JobActivity event handler immediately +after the call to jobstart() is not a race because the Nvim job system will +not publish the job result (even though it may receive it) until evaluation of +the chained user commands (`expr1|expr2|...|exprN`) has completed. + Job control is achieved by calling a combination of the |jobstart()|, |jobsend()| and |jobstop()| functions, and by listening to the |JobActivity| event. The best way to understand is with a complete example: -- cgit