sphinx_doc_src/cmds/wait.rst

wait - wait for jobs to complete
==========================================

Synopsis
--------

wait [-n | --any] [PID | PROCESS_NAME] ...


Description
------------

`wait` waits for child jobs to complete.

- If a pid is specified, the command waits for the job that the process with the pid belongs to.
- If a process name is specified, the command waits for the jobs that the matched processes belong to.
- If neither a pid nor a process name is specified, the command waits for all background jobs.
- If the `-n` / `--any` flag is provided, the command returns as soon as the first job completes. If it is not provided, it returns after all jobs complete.

Example
------------


::

    sleep 10 &
    wait $last_pid

spawns `sleep` in the background, and then waits until it finishes.


::

    for i in (seq 1 5); sleep 10 &; end
    wait

spawns five jobs in the background, and then waits until all of them finishes.


::

    for i in (seq 1 5); sleep 10 &; end
    hoge &
    wait sleep

spawns five jobs and `hoge` in the background, and then waits until all `sleep`s finishes, and doesn't wait for `hoge` finishing.
Switch command docs from \section to reStructuredText 2018-12-16 17:39:33 -08:00			`wait - wait for jobs to complete`
			`==========================================`

Migrate the 'synopsis' sections to .rst format 2018-12-17 17:58:24 -08:00			`Synopsis`
			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00
			`wait [-n \| --any] [PID \| PROCESS_NAME] ...`
Migrate the 'synopsis' sections to .rst format 2018-12-17 17:58:24 -08:00
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00
Convert \\subsection sections into rst format 2018-12-18 18:44:30 -08:00			`Description`
			`------------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00
			`wait` waits for child jobs to complete.

			`- If a pid is specified, the command waits for the job that the process with the pid belongs to.`
			`- If a process name is specified, the command waits for the jobs that the matched processes belong to.`
			`- If neither a pid nor a process name is specified, the command waits for all background jobs.`
			- If the `-n` / `--any` flag is provided, the command returns as soon as the first job completes. If it is not provided, it returns after all jobs complete.

Convert \\subsection sections into rst format 2018-12-18 18:44:30 -08:00			`Example`
			`------------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00
Switch \fish sections to rst format 2018-12-18 19:14:04 -08:00

			`::`

			`sleep 10 &`
			`wait $last_pid`

Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00			spawns `sleep` in the background, and then waits until it finishes.
Switch \fish sections to rst format 2018-12-18 19:14:04 -08:00

			`::`

			`for i in (seq 1 5); sleep 10 &; end`
			`wait`

Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00			`spawns five jobs in the background, and then waits until all of them finishes.`
Switch \fish sections to rst format 2018-12-18 19:14:04 -08:00

			`::`

			`for i in (seq 1 5); sleep 10 &; end`
			`hoge &`
			`wait sleep`

Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 13:08:41 -08:00			spawns five jobs and `hoge` in the background, and then waits until all `sleep`s finishes, and doesn't wait for `hoge` finishing.