diff --git a/CHANGELOG.md b/CHANGELOG.md index 51ed110c1..ba83484cb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -42,6 +42,7 @@ This section is for changes merged to the `major` branch that are not also merge - A pipe at the end of a line now allows the job to continue on the next line (#1285) - The names `argparse`, `read`, `set`, `status`, `test` and `[` are now reserved and not allowed as function names. This prevents users unintentionally breaking stuff (#3000). - Wrapping completions (from `complete -w` or `function -w`) can now inject arguments. For example, `complete gco -w 'git checkout'` now works properly (#1976). The `alias` function has been updated to respect this behavior. +- The `jobs` builtin now has a `-q` and `--quiet` option to silence the output. ## Other significant changes - Command substitution output is now limited to 10 MB by default (#3822). diff --git a/doc_src/jobs.txt b/doc_src/jobs.txt index 613266d32..df4fd9f10 100644 --- a/doc_src/jobs.txt +++ b/doc_src/jobs.txt @@ -19,8 +19,14 @@ jobs accepts the following switches: - `-p` or `--pid` prints the process ID for each process in all jobs. +- `-q` or `--quiet` prints no output for evaluation of jobs by exit code only. + On systems that supports this feature, jobs will print the CPU usage of each job since the last command was executed. The CPU usage is expressed as a percentage of full CPU activity. Note that on multiprocessor systems, the total activity may be more than 100\%. +The exit code of the `jobs` builtin is `0` if there are running background jobs and `1` otherwise. + +\subsection prints no output. + \subsection jobs-example Example