Install some example logging configuration files

CMakeLists.txt

@@ -1573,6 +1573,13 @@ install (FILES
   #COMPONENT runtime
   )
 
+install (DIRECTORY
+  example_log_configurations
+  DESTINATION ${CMAKE_INSTALL_DOCDIR}
+  FILES_MATCHING REGEX "^.*[^~]$"
+  #COMPONENT runtime
+  )
+
 #
 # Mac installer files
 #

example_log_configurations/README

@@ -0,0 +1,5 @@
+Example WSJT-X Logging Configuration Files
+==========================================
+
+Here you  will find  some typical loggin  configuration files.  Pick a
+suitable one and copy it to the WSJT-X log files directory.

example_log_configurations/wsjtx_log_config.ini.console

@@ -0,0 +1,14 @@
+#
+# Example logging confguration file to send records to the console terminal
+#
+
+[Core]
+# Set DisableLogging to true to disable all logging.
+DisableLogging="false"
+
+[Sinks.Console]
+Destination="Console"
+Asynchronous="false"
+AutoFlush="true"
+Format="[%TimeStamp(format=\"%H:%M:%S.%f\")%][%Channel%:%Severity%] %Message%"
+Filter="(%Channel% matches \"SYSLOG\" & %Severity% >= trace) | (%Channel% matches \"RIGCTRL\" & %Severity% >= info)"

example_log_configurations/wsjtx_log_config.ini.debugger

@@ -0,0 +1,15 @@
+#
+# Example WSJT-X logging configuration for sending records to the
+# attached Windows debugger (e.g. gdb)
+#
+
+[Core]
+# Set DisableLogging to true to disable all logging.
+DisableLogging="false"
+
+[Sinks.Debugger]
+Destination="Debugger"
+Asynchronous="false"
+AutoFlush="true"
+Format="[%TimeStamp(format=\"%H:%M:%S.%f\")%][%Channel%][%Severity%] %File%(%Line%) %Function%: %Message%"
+Filter="(%Channel% matches \"SYSLOG\" & %Severity% >= debug) | (%Channel% matches \"RIGCTRL\" & %Severity% >= info)"

example_log_configurations/wsjtx_log_config.ini.simple_verbose

@@ -0,0 +1,14 @@
+[Sinks.SYSLOG]
+Destination="TextFile"
+Asynchronous="true"
+AutoFlush="true"
+Format="[%TimeStamp(format=\"%Y-%m-%d %H:%M:%S.%f\")%][%Uptime(format=\"%O:%M:%S.%f\")%][%Channel%][%Severity%] %File%(%Line%) %Function%: %Message%"
+RotationTimePoint="11:42:00"
+Target="${AppLocalDataLocation}/logs"
+FileName="${AppLocalDataLocation}/wsjtx_syslog.log"
+TargetFileName="${AppLocalDataLocation}/logs/wsjtx_syslog_%Y-%m_%3N.log"
+Append="true"
+EnableFinalRotation="false"
+ScanForFiles="Matching"
+MaxSize=1073741824
+MaxFiles="10"