aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc_src/source.txt
diff options
context:
space:
mode:
authorGravatar axel <axel@liljencrantz.se>2007-04-23 07:19:47 +1000
committerGravatar axel <axel@liljencrantz.se>2007-04-23 07:19:47 +1000
commit2b7535bb518c909e2a6ce1352df93c5c6bbc084b (patch)
treecfce1fe4a8073a4f855b8f73390d2cda4d8ff740 /doc_src/source.txt
parentc5805cfd472dd082a7adc02e02cb87ee5b7d7f81 (diff)
Make the . (source) builtin able to read commands from stdin
darcs-hash:20070422211947-ac50b-b8d33d81fcef5e0b7e76a8d2a9f0bcbcf3ac67b7.gz
Diffstat (limited to 'doc_src/source.txt')
-rw-r--r--doc_src/source.txt9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc_src/source.txt b/doc_src/source.txt
index 8cbc9c88..54d1e342 100644
--- a/doc_src/source.txt
+++ b/doc_src/source.txt
@@ -1,7 +1,7 @@
\section source . - evaluate contents of file.
\subsection source-synopsis Synopsis
-<tt>. FILENAME</tt>
+<tt>. FILENAME [ARGUMENTS...]</tt>
\subsection source-description Description
@@ -9,7 +9,12 @@ 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, etc., will remain.
+environment variables, etc., will remain. 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.
\subsection source-example Example