Copy doc_src to sphinx_doc_src and add a TOC

sphinx_doc_src/cmds/wait.rst

@@ -0,0 +1,34 @@
+\section wait wait - wait for jobs to complete
+
+\subsection wait-synopsis Synopsis
+\fish{synopsis}
+wait [-n | --any] [PID | PROCESS_NAME] ...
+\endfish
+
+\subsection wait-description 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.
+
+\subsection wait-example Example
+
+\fish
+sleep 10 &
+wait $last_pid
+\endfish
+spawns `sleep` in the background, and then waits until it finishes.
+\fish
+for i in (seq 1 5); sleep 10 &; end
+wait
+\endfish
+spawns five jobs in the background, and then waits until all of them finishes.
+\fish
+for i in (seq 1 5); sleep 10 &; end
+hoge &
+wait sleep
+\endfish
+spawns five jobs and `hoge` in the background, and then waits until all `sleep`s finishes, and doesn't wait for `hoge` finishing.