/**
  * Set the logger. Replaces all other loggers.
  * Use {@link add_logger()} to append a logger to the chain.
  * @param LOGGER $logger
  * @param boolean $copy_settings Copies settings from the current logger if
  * <code>True</code>.
  */
 public function set_logger($logger, $copy_settings = true)
 {
     if ($copy_settings && $this->logger) {
         $this->logger->copy_settings_to($logger);
     }
     $this->logger = $logger;
 }