fish-shell/doc_src/command.txt

\section command command - run a program

\subsection command-synopsis Synopsis
\fish{synopsis}
command [OPTIONS] COMMANDNAME [ARGS...]
\endfish

\subsection command-description Description

`command` forces the shell to execute the program `COMMANDNAME` and ignore any functions or builtins with the same name.

The following options are available:

- `-a` or `--all` returns all the external commands that are found in `$PATH` in the order they are found.

- `-q` or `--quiet`, silences the output and prints nothing, setting only the exit code. Implies `--search`.

- `-s` or `--search` returns the name of the external command that would be executed, or nothing if no file with the specified name could be found in the `$PATH`.

With the `-s` option, `command` treats every argument as a separate command to look up and sets the exit status to 0 if any of the specified commands were found, or 1 if no commands could be found. Additionally passing a `-q` or `--quiet` option prevents any paths from being printed, like `type -q`, for testing only the exit status.

For basic compatibility with POSIX `command`, the `-v` flag is recognized as an alias for `-s`.

\subsection command-example Examples

`command ls` causes fish to execute the `ls` program, even if an `ls` function exists.

`command -s ls` returns the path to the `ls` program.

`command -q git; and command git log` runs `git log` only if `git` exists.
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00			`\section command command - run a program`

			`\subsection command-synopsis Synopsis`
Rebase documentation changes 2014-09-03 14:10:53 +00:00			`\fish{synopsis}`
			`command [OPTIONS] COMMANDNAME [ARGS...]`
			`\endfish`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
			`\subsection command-description Description`

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 02:37:32 +00:00			`command` forces the shell to execute the program `COMMANDNAME` and ignore any functions or builtins with the same name.
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
Teach `command` builtin a -p/--path flag Give the `command` builtin a single flag, -p/--path, that causes it to print the full path that would be executed for the given command. 2014-07-10 01:21:06 +00:00			`The following options are available:`

implement `command -a` Fixes #2778 2017-06-23 22:42:38 +00:00			- `-a` or `--all` returns all the external commands that are found in `$PATH` in the order they are found.

Let `command -q` work This required "-sq" to be used and errored if just "-q" was given. Instead, if only "-q" is given, we behave just as if "-sq" was. 2019-02-09 11:51:55 +00:00			- `-q` or `--quiet`, silences the output and prints nothing, setting only the exit code. Implies `--search`.
Include --quiet in `command` builtin summary 2017-10-04 10:02:52 +00:00
implement `command -a` Fixes #2778 2017-06-23 22:42:38 +00:00			- `-s` or `--search` returns the name of the external command that would be executed, or nothing if no file with the specified name could be found in the `$PATH`.
command: Rename -p/--path flag to -s/--search 2014-07-11 02:16:32 +00:00
[docs] Some rewording to the builtins Plus some additional examples. 2018-05-13 22:36:49 +00:00			With the `-s` option, `command` treats every argument as a separate command to look up and sets the exit status to 0 if any of the specified commands were found, or 1 if no commands could be found. Additionally passing a `-q` or `--quiet` option prevents any paths from being printed, like `type -q`, for testing only the exit status.
Rebase documentation changes 2014-09-03 14:10:53 +00:00
			For basic compatibility with POSIX `command`, the `-v` flag is recognized as an alias for `-s`.
Teach `command` builtin a -p/--path flag Give the `command` builtin a single flag, -p/--path, that causes it to print the full path that would be executed for the given command. 2014-07-10 01:21:06 +00:00
			`\subsection command-example Examples`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 13:31:55 +00:00
Rebase documentation changes 2014-09-03 14:10:53 +00:00			`command ls` causes fish to execute the `ls` program, even if an `ls` function exists.
Teach `command` builtin a -p/--path flag Give the `command` builtin a single flag, -p/--path, that causes it to print the full path that would be executed for the given command. 2014-07-10 01:21:06 +00:00
Rebase documentation changes 2014-09-03 14:10:53 +00:00			`command -s ls` returns the path to the `ls` program.
[docs] Some rewording to the builtins Plus some additional examples. 2018-05-13 22:36:49 +00:00
Let `command -q` work This required "-sq" to be used and errored if just "-q" was given. Instead, if only "-q" is given, we behave just as if "-sq" was. 2019-02-09 11:51:55 +00:00			`command -q git; and command git log` runs `git log` only if `git` exists.