fish/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:

- `-s` or `--search` returns the name of the disk file 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.

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.
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 23:31:55 +10:00			`\section command command - run a program`

			`\subsection command-synopsis Synopsis`
Rebase documentation changes 2014-09-03 15:10:53 +01:00			`\fish{synopsis}`
			`command [OPTIONS] COMMANDNAME [ARGS...]`
			`\endfish`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 23:31:55 +10: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 03:37:32 +01: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 23:31:55 +10: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-09 18:21:06 -07:00			`The following options are available:`

Rebase documentation changes 2014-09-03 15:10:53 +01:00			- `-s` or `--search` returns the name of the disk file 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-10 19:16:32 -07:00
Rebase documentation changes 2014-09-03 15:10:53 +01: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.

			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-09 18:21:06 -07:00
			`\subsection command-example Examples`
Add subdirectories darcs-hash:20050920133155-ac50b-9a14c6c664dd03afbe8e15e7c7998fcfb5c3c750.gz 2005-09-20 23:31:55 +10:00
Rebase documentation changes 2014-09-03 15:10:53 +01: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-09 18:21:06 -07:00
Rebase documentation changes 2014-09-03 15:10:53 +01:00			`command -s ls` returns the path to the `ls` program.