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

These two deserve some explanation...

1 files changed, 5 insertions, 0 deletions

diff --git a/src/basic/log.h b/src/basic/log.h
index fa87b9fb5..78a6e54c9 100644
--- 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