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 fa87b9fb59a2c195c5e30db48e7b22eab6e69310..78a6e54c9270e131d07be991a2a38dcdb51c076c 100644 (file)
--- a/src/basic/log.h
+++ b/src/basic/log.h
@@ -312,8 +312,13 @@ 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);
 #endif // 0
+
+/* 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