mirror of
https://github.com/fish-shell/fish-shell.git
synced 2024-11-27 11:43:37 +08:00
053d940d0a
In order to allow the execution of commands before dropping to an interactive prompt, a new switch, '-C' or '--init-command' has been added to those switches that we accept. The documentation has been updated correspondingly. The original code only supported a single command list to be executed, and this command list terminates the shell when it completes. To allow the new command list to preceed the original one, both have been wrapped in a new container class 'command_line_switches_t'. This is then passed around in place of the list of strings we used previously. I had considered moving the interactive, login and other command line switch states into this container, but doing so would change far more of the code, moving the structure to be available globally, and I wasn't confident of the impact. However, this might be a useful thing to do in the future. A new function, run_command_list, was lifted from the prior execution code, and re-used for both the initial command and the regular command execution.
33 lines
1.7 KiB
Plaintext
33 lines
1.7 KiB
Plaintext
\section fish fish - the friendly interactive shell
|
|
|
|
\subsection fish-synopsis Synopsis
|
|
\fish{synopsis}
|
|
fish [OPTIONS] [-c command] [FILE [ARGUMENTS...]]
|
|
\endfish
|
|
|
|
\subsection fish-description Description
|
|
|
|
`fish` is a command-line shell written mainly with interactive use in mind. The full manual is available <a href='index.html'>in HTML</a> by using the <a href='#help'>help</a> command from inside fish.
|
|
|
|
The following options are available:
|
|
|
|
- `-c` or `--command=COMMANDS` evaluate the specified commands instead of reading from the commandline
|
|
|
|
- `-C` or `--init-command=COMMANDS` evaluate the specified commands after reading the configuration, before running the command specified by `-c` or reading interactive input
|
|
|
|
- `-d` or `--debug-level=DEBUG_LEVEL` specify the verbosity level of fish. A higher number means higher verbosity. The default level is 1.
|
|
|
|
- `-i` or `--interactive` specify that fish is to run in interactive mode
|
|
|
|
- `-l` or `--login` specify that fish is to run as a login shell
|
|
|
|
- `-n` or `--no-execute` do not execute any commands, only perform syntax checking
|
|
|
|
- `-p` or `--profile=PROFILE_FILE` when fish exits, output timing information on all executed commands to the specified file
|
|
|
|
- `-v` or `--version` display version and exit
|
|
|
|
- `-D` or `--debug-stack-frames=DEBUG_LEVEL` specify how many stack frames to display when debug messages are written. The default is zero. A value of 3 or 4 is usually sufficient to gain insight into how a given debug call was reached but you can specify a value up to 128.
|
|
|
|
The fish exit status is generally the exit status of the last foreground command. If fish is exiting because of a parse error, the exit status is 127.
|