2013-08-14 23:55:15 +08:00
|
|
|
\section source source - evaluate contents of file.
|
2005-09-20 21:31:55 +08:00
|
|
|
|
|
|
|
|
\subsection source-synopsis Synopsis
|
2013-08-14 23:55:15 +08:00
|
|
|
<tt>source FILENAME [ARGUMENTS...]</tt>
|
2005-09-20 21:31:55 +08:00
|
|
|
|
2010-09-18 10:18:26 +08:00
|
|
|
\subsection source-description Description
|
2005-09-20 21:31:55 +08:00
|
|
|
|
2013-08-14 23:55:15 +08:00
|
|
|
\c source evaluates the commands of the specified file in the current
|
2005-09-20 21:31:55 +08:00
|
|
|
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
|
2014-04-19 08:16:37 +08:00
|
|
|
shell variables will affect the current shell. If additional arguments are
|
2007-04-23 05:19:47 +08:00
|
|
|
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.
|
2005-09-20 21:31:55 +08:00
|
|
|
|
2013-08-14 23:55:15 +08:00
|
|
|
The return status of \c source is the return status of the last job to
|
2007-10-05 22:58:08 +08:00
|
|
|
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.
|
2007-10-05 22:58:08 +08:00
|
|
|
|
2013-10-28 09:57:36 +08:00
|
|
|
\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.
|
|
|
|
|
|
2005-09-20 21:31:55 +08:00
|
|
|
\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.
|
2005-09-20 21:31:55 +08:00
|
|
|
|
