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.
