diff --git a/doc_src/eval.txt b/doc_src/eval.txt index f8af8f666..47e4627dc 100644 --- a/doc_src/eval.txt +++ b/doc_src/eval.txt @@ -9,7 +9,7 @@ \subsection eval-example Example The following code will call the ls command. Note that \c fish does not -support the use of environment variables as direct commands; \c eval can +support the use of shell variables as direct commands; \c eval can be used to work around this.
diff --git a/doc_src/index.hdr.in b/doc_src/index.hdr.in index 51bf4e43d..9e67724ab 100644 --- a/doc_src/index.hdr.in +++ b/doc_src/index.hdr.in @@ -413,7 +413,7 @@ command line. These are the general purpose tab completions that \c fish provides: - Completion of commands (builtins, functions and regular programs). -- Completion of environment variable names. +- Completion of shell variable names. - Completion of usernames for tilde expansion. - Completion of filenames, even on strings with wildcards such as '*', '**' and '?'. - Completion of job ID, job name and process names for process expansion. @@ -559,7 +559,7 @@ undergoes the process of parameter expansion before it is sent on to the command. Parameter expansion is a powerful mechanism that allows you to expand the parameter in various ways, including performing wildcard matching on files, inserting the value of -environment variables into the parameter or even using the output of +a shell variable into the parameter or even using the output of another command as a parameter list. \subsection expand-wildcard Wildcards @@ -634,10 +634,10 @@ The commandmv *.{c,h} src/
moves all files with the suffix \subsection expand-variable Variable expansion -A dollar sign followed by a string of characters is expanded into the -value of the environment variable with the same name. For an -introduction to the concept of environment variables, read the Environment variables section. +A dollar sign followed by a string of characters is expanded into the +value of the shell variable with the same name. For an +introduction to the concept of shell variables, read the +Shell variables section. Undefined and empty variables expand to nothing. @@ -699,7 +699,7 @@ instead be expressed as$$foo[1][5]
. \subsection expand-index-range Index range expansion -Both command substitution and environment variables support accessing only +Both command substitution and shell variable expansion support accessing only specific items by providing a set of indices in square brackets. It's often needed to access a sequence of elements. To do this, use the range operator '..' for this. A range'a..b'
, where range limits 'a' @@ -799,10 +799,12 @@ If the current directory contains the files 'foo' and 'bar', the command will output 'abar1 abar2 abar3 afoo1 afoo2 afoo3'. -\section variables Environment variables +\section variables Shell variables -Environment variables are named pieces of data, which can be created, deleted -and their values changed and used by the user. +Shell variables are named pieces of data, which can be created, deleted +and their values changed and used by the user. Variables may optionally be "exported", so +that a copy of the variable is available to any subprocesses the shell creates. An +exported variable is referred to as an "environment variable". To set a variable value, use the \c set command. diff --git a/doc_src/math.txt b/doc_src/math.txt index 9904a2cce..8e1fd3b51 100644 --- a/doc_src/math.txt +++ b/doc_src/math.txt @@ -14,7 +14,7 @@ or a pipeline. For a description of the syntax supported by math, see the manual for the bc program. Keep in mind that parameter expansion takes place on any expressions before they are evaluated. This can be very useful in -order to perform calculations involving environment variables or the +order to perform calculations involving shell variables or the output of command substitutions, but it also means that parenthesis have to be escaped. diff --git a/doc_src/read.txt b/doc_src/read.txt index 1e8aef373..bb13f991b 100644 --- a/doc_src/read.txt +++ b/doc_src/read.txt @@ -6,7 +6,7 @@ \subsection read-description Description read reads one line from standard -input and stores the result in one or more environment variables. +input and stores the result in one or more shell variables. The following options are available: @@ -17,17 +17,17 @@ The following options are available: - -p PROMPT_CMD or --prompt=PROMPT_CMD uses the output of the shell command \c PROMPT_CMD as the prompt for the interactive mode. The default prompt command is set_color green; echo read; set_color normal; echo "> ". --s
or--shell
enables syntax highlighting, tab completions and command termination suitable for entering shellscript code in the interactive mode. --u
or--unexport
prevents the variables from being exported to child processes (default behaviour). ---U
or--universal
causes the specified environment variable to be made universal. +--U
or--universal
causes the specified shell variable to be made universal. --x
or--export
exports the variables to child processes. \c read reads a single line of input from stdin, breaks it into tokens -based on the IFS environment variable, and then assigns one +based on the IFS shell variable, and then assigns one token to each variable specified in VARIABLES. If there are more tokens than variables, the complete remainder is assigned to the last variable. \subsection read-example Example -The following code stores the value 'hello' in the environment variable +The following code stores the value 'hello' in the shell variable $foo. echo hello|read foo diff --git a/doc_src/set.txt b/doc_src/set.txt index e9e67392e..a78d30468 100644 --- a/doc_src/set.txt +++ b/doc_src/set.txt @@ -1,4 +1,4 @@ -\section set set - display and change environment variables. +\section set set - display and change shell variables. \subsection set-synopsis Synopsis@@ -12,11 +12,11 @@ set (-e | --erase) [SCOPE_OPTIONS] VARIABLE_NAME[INDICES]... \subsection set-description Description -set
manipulates environment +set
manipulates shell variables. If set is called with no arguments, the names and values of all -environment variables are printed. If some of the scope or export +shell variables are printed. If some of the scope or export flags have been given, only the variables matching the specified scope are printed. @@ -24,15 +24,15 @@ With both variable names and values provided, \c set assigns the variableVARIABLE_NAME
the valuesVALUES...
. The following options control variable scope: ---l
or--local
forces the specified environment variable to be given a scope that is local to the current block, even if a variable with the given name exists and is non-local ---g
or--global
causes the specified environment variable to be given a global scope. Non-global variables disappear when the block they belong to ends ---U
or--universal
causes the specified environment variable to be given a universal scope. If this option is supplied, the variable will be shared between all the current users fish instances on the current computer, and will be preserved across restarts of the shell. +--l
or--local
forces the specified shell variable to be given a scope that is local to the current block, even if a variable with the given name exists and is non-local +--g
or--global
causes the specified shell variable to be given a global scope. Non-global variables disappear when the block they belong to ends +--U
or--universal
causes the specified shell variable to be given a universal scope. If this option is supplied, the variable will be shared between all the current users fish instances on the current computer, and will be preserved across restarts of the shell. --n
or--names
List only the names of all defined variables, not their value ---u
or--unexport
causes the specified environment not to be exported to child processes ---x
or--export
causes the specified environment variable to be exported to child processes +--x
or--export
causes the specified shell variable to be exported to child processes (making it an "environment variable") +--u
or--unexport
causes the specified shell variable to NOT be exported to child processes The following options are available: ---e
or--erase
causes the specified environment variable to be erased +--e
or--erase
causes the specified shell variable to be erased --q
or--query
test if the specified variable names are defined. Does not output anything, but the builtins exit status is the number of variables specified that were not defined. --L
or--long
do not abbreviate long values when printing set variables diff --git a/doc_src/source.txt b/doc_src/source.txt index 786577dc4..8798e9d9f 100644 --- a/doc_src/source.txt +++ b/doc_src/source.txt @@ -9,7 +9,7 @@ shell. This is different from starting a new process to perform the commands (i.e. fish < FILENAME) 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 +shell variables will affect the current shell. If additional arguments are specified after the file name, they will be inserted into the $argv variable. diff --git a/doc_src/tutorial.hdr b/doc_src/tutorial.hdr index f28541b82..58f925d5e 100644 --- a/doc_src/tutorial.hdr +++ b/doc_src/tutorial.hdr @@ -193,7 +193,7 @@ h3 { font-size: 110%; }
> man set -set - handle environment variables +set - handle shell variables Synopsis...@@ -429,7 +429,7 @@ Unlike other shells, fish stores the exit status of the last command in $sta Zero is considered success, and non-zero is failure. -