\section read read - print currently running read

\subsection read-synopsis Synopsis
<tt>read [VARIABLES...]</tt>

\subsection read-description Description

The <tt>read</tt> builtin causes fish to read one line from standard
input and store the result in one or more environment variables. 

Read starts by reading a single line of input from stdin, the line is
then tokenized using the <tt>IFS</tt> environment variable. Each variable
specified in <tt>VARIABLES</tt> is then assigned one tokenized string
element. If there are more tokens than variables, the complete
remainder is assigned to the last variable.

\subsection read-example Example

<tt>echo hello|read foo</tt>

Will cause the variable \$foo to be assigned the value hello.
