fish-shell/doc_src/source.txt

31 lines
1.1 KiB
Plaintext
Raw Normal View History

2013-08-14 23:55:15 +08:00
\section source source - evaluate contents of file.
\subsection source-synopsis Synopsis
2013-08-14 23:55:15 +08:00
<tt>source FILENAME [ARGUMENTS...]</tt>
2010-09-18 10:18:26 +08:00
\subsection source-description Description
2013-08-14 23:55:15 +08:00
\c source evaluates the commands of the specified file in the current
shell. This is different from starting a new process to perform the
commands (i.e. <tt>fish < FILENAME</tt>) since the commands will be
evaluated by the current shell, which means that changes in
environment variables affect the current shell. If additional arguments are
specified after the file name, they will be inserted into the $argv
variable.
If no file is specified, or if the file name '-' is used, stdin will
be read.
2013-08-14 23:55:15 +08:00
The return status of \c source is the return status of the last job to
execute. If something goes wrong while opening or reading the file,
2013-08-14 23:55:15 +08:00
\c source exits with a non-zero status.
\c . (a single period) is an alias for the \c source command. The use of \c .
is deprecated in favour of \c source, and \c . will be removed in a future
version of fish.
\subsection source-example Example
2013-08-14 23:55:15 +08:00
<tt>source ~/.config/fish/config.fish</tt> causes fish to re-read its initialization file.