       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.
