read  [  -rzpqAclneE ] [ -k [ num ] ] [ -un ] [
       name[?prompt] ] [ name ...  ]
       Read  one  line  and break it into fields using the
       characters in $IFS as separators.

       -r     Raw mode: a `\' at the end of  a  line  does
              not signify line continuation.

       -q     Read  only  one  character from the terminal
              and set name to `y' if  this  character  was
              `y'  or `Y' and to `n' otherwise.  With this
              flag set the return value is  zero  only  if
              the character was `y' or `Y'.

       -k [ num ]
              Read  only  one (or num) characters from the
              terminal.

       -z     Read from  the  editor  buffer  stack.   The
              first  field  is assigned to the first name,
              the second field to the second  name,  etc.,
              with  leftover  fields  assigned to the last
              name.

       -e
       -E     The words read are printed after  the  whole
              line  is  read.  If  the -e flag is set, the
              words are not assigned to the parameters.

       -A     The first name is taken as the  name  of  an
              array and all words are assigned to it.

       -c
       -l     These  flags  are  allowed  only  if  called
              inside a function used for completion (spec-
              ified  with  the -K flag to compctl). If the
              -c flag is given, the words of  the  current

              command  are  read. If the -l flag is given,
              the whole line is assigned as a scalar.   If
              name  is  omitted  then  REPLY  is  used for
              scalars and reply for arrays.

       -n     Together with either of the previous  flags,
              this option gives the number of the word the
              cursor is on or the index of  the  character
              the cursor is on respectively.

       -un    Input is read from file descriptor n.

       -p     Input is read from the coprocess.

       If the first argument contains a `?', the remainder
       of this word is used as a prompt on standard  error
       when  the shell is interactive.  The exit status is
       0 unless an end-of-file is encountered.
