fish-shell/doc_src/bg.txt

\section bg bg - send jobs to background

\subsection bg-synopsis Synopsis
\fish{synopsis}
bg [PID...]
\endfish

\subsection bg-description Description

`bg` sends <a href="index.html#syntax-job-control">jobs</a> to the background, resuming them if they are stopped. A background job is executed simultaneously with fish, and does not have access to the keyboard. If no job is specified, the last job to be used is put in the background. If PID is specified, the jobs with the specified process group IDs are put in the background.

The PID of the desired process is usually found by using <a href="index.html#expand-process">process expansion</a>.

When at least one of the arguments isn't a valid job specifier (i.e. PID),
`bg` will print an error without backgrounding anything.

When all arguments are valid job specifiers, bg will background all matching jobs that exist.

\subsection bg-example Example

`bg %1` will put the job with job ID 1 in the background.

`bg 123 456 789` will background 123, 456 and 789.

If only 123 and 789 exist, it will still background them and print an error about 456.

`bg 123 banana` or `bg banana 123` will complain that "banana" is not a valid job specifier.
Help cleanup Large list of changes, including formatting and typos for most commands. More substantive changes have been made to alias, bind, block, break, builtin, case, cd, commandline, count, else, emit, fish_config, funced, function, functions, history, math, mimedb, nextd, not, popd, prevd, pushd, pwd, random, read, set, set_color, switch, test, trap, type, ulimit, umask, and while. 2013-05-12 15:56:01 +08:00			`\section bg bg - send jobs to background`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 21:31:55 +08:00
			`\subsection bg-synopsis Synopsis`
Simplify styling 2014-08-01 20:25:41 +08:00			`\fish{synopsis}`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 10:37:32 +08:00			`bg [PID...]`
			`\endfish`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 21:31:55 +08:00
			`\subsection bg-description Description`
Help cleanup Large list of changes, including formatting and typos for most commands. More substantive changes have been made to alias, bind, block, break, builtin, case, cd, commandline, count, else, emit, fish_config, funced, function, functions, history, math, mimedb, nextd, not, popd, prevd, pushd, pwd, random, read, set, set_color, switch, test, trap, type, ulimit, umask, and while. 2013-05-12 15:56:01 +08:00
Make line length, wrapping and spacing consistent 2014-08-19 20:41:23 +08:00			`bg` sends <a href="index.html#syntax-job-control">jobs</a> to the background, resuming them if they are stopped. A background job is executed simultaneously with fish, and does not have access to the keyboard. If no job is specified, the last job to be used is put in the background. If PID is specified, the jobs with the specified process group IDs are put in the background.
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 21:31:55 +08:00
Minor documentation fixes darcs-hash:20070324191646-ac50b-0892de7e96348caf198830af2b2ad46b84f9f13e.gz 2007-03-25 03:16:46 +08:00			`The PID of the desired process is usually found by using <a href="index.html#expand-process">process expansion</a>.`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 21:31:55 +08:00
Improve `bg` argument handling - Error out if anything that is not a PID is given - Otherwise background all matching existing jobs, even if not all PIDs exist (but print a message for the non-existing ones) Fixes #3909. 2017-04-02 23:02:55 +08:00			`When at least one of the arguments isn't a valid job specifier (i.e. PID),`
			`bg` will print an error without backgrounding anything.

			`When all arguments are valid job specifiers, bg will background all matching jobs that exist.`
Make line length, wrapping and spacing consistent 2014-08-19 20:41:23 +08:00
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 21:31:55 +08:00			`\subsection bg-example Example`

Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 10:37:32 +08:00			`bg %1` will put the job with job ID 1 in the background.
Improve `bg` argument handling - Error out if anything that is not a PID is given - Otherwise background all matching existing jobs, even if not all PIDs exist (but print a message for the non-existing ones) Fixes #3909. 2017-04-02 23:02:55 +08:00
			`bg 123 456 789` will background 123, 456 and 789.

			`If only 123 and 789 exist, it will still background them and print an error about 456.`

			`bg 123 banana` or `bg banana 123` will complain that "banana" is not a valid job specifier.