log: add brief comment for log_set_open_when_needed() and log_set_always_reopen_console()

These two deserve some explanation...

diff --git a/src/basic/log.h b/src/basic/log.h
index 0a8fa228662ac603b296e15c13c81934884d545b..cc767ba1a9dc1a06616d4a53079628de305b1926 100644 (file)
--- a/src/basic/log.h
+++ b/src/basic/log.h
@@ -304,7 +304,12 @@ void log_received_signal(int level, const struct signalfd_siginfo *si);
 
 /* If turned on, any requests for a log target involving "syslog" will be implicitly upgraded to the equivalent journal target */
 void log_set_upgrade_syslog_to_journal(bool b);
+
+/* If turned on, and log_open() is called, we'll not use STDERR_FILENO for logging ever, but rather open /dev/console */
 void log_set_always_reopen_console(bool b);
+
+/* If turned on, we'll open the log stream implicitly if needed on each individual log call. This is normally not
+ * desired as we want to reuse our logging streams. It is useful however  */
 void log_set_open_when_needed(bool b);
 
 /* If turned on, then we'll never use IPC-based logging, i.e. never log to syslog or the journal. We'll only log to