

   SSeenndd OOuuttppuutt ttoo aa FFiillee

        sink(file = NULL)

   AArrgguummeennttss::

       file: a character string naming the file to write to, or
             `NULL' to stop ``sink''ing.

   DDeessccrriippttiioonn::

        `sink(file)' diverts all R output to `file' (overwrit-
        ing the file if it already exists;  appending is not
        supported yet).  Only prompts and error messages con-
        tinue to appear on the terminal.

        `sink()' or `sink(file=NULL)' ends the diversion.

   EExxaammpplleess::

        sink("sink-examp.txt")
        i <- 1:10
        outer(i,i,"*")
        sink()

