Reconfigure logging if the logging channel is changed

and add documentation about the feature. Refs #29987

Framework/Kernel/src/ConfigService.cpp

@@ -953,6 +953,9 @@ void ConfigServiceImpl::setString(const std::string &key,
     cacheInstrumentPaths();
   } else if (key == "defaultsave.directory") {
     appendDataSearchDir(value);
+  } else if (key == "logging.channels.consoleChannel.class") {
+    // this key requires reloading logging for it to take effect
+    configureLogging();
   }
 
   m_notificationCenter.postNotification(new ValueChanged(key, value, old));

docs/source/concepts/PropertiesFile.rst

@@ -136,7 +136,13 @@ you may want to alter and those properties are detailed below.
 |                                                 |The default is information, but                    | ``error``, ``critical``     |
 |                                                 |this can be lowered to debug for more detailed     | or ``fatal``                |
 |                                                 |feedback.                                          |                             |
-|                                                 |                                                   |                             |
++-------------------------------------------------+---------------------------------------------------+-----------------------------+
+| ``logging.channels.consoleChannel.class``       | Select where log messages appear.                 | ``ConsoleChannel``,         |
+|                                                 | ``ConsoleChannel`` writes to stdlog.              | ``StdoutChannel``, or       |
+|                                                 | ``StdoutChannel`` writes to stdout and can be     | ``PythonStdoutChannel``     |
+|                                                 | redirected using pipes.                           |                             |
+|                                                 | ``PythonStdoutChannel`` writes to stdout through  |                             |
+|                                                 | python and is visible in jupyter notebooks.       |                             |
 +-------------------------------------------------+---------------------------------------------------+-----------------------------+
 
 The logging priority levels for the file logging and console logging can also be adjusted in python using the command:

docs/source/release/v6.0.0/framework.rst

@@ -15,6 +15,7 @@ Concepts
 - Change sphinx documentation to use mathjax to render equations
 - Added packing fraction to :ref:`Material <Materials>` to separate number density and effective number density.
 - Added a feature allowing time-dependent values for individual instrument parameters.
+- Added a ``PythonStdOutChannel`` and the ability to change the :ref:`logging channel <Properties File>` without restarting mantid framework
 
 Algorithms
 ----------