From 884798c3cbdcd82372abd7bb88403774ce292cc4 Mon Sep 17 00:00:00 2001
From: Sitaram Chamarty <sitaramc@gmail.com>
Date: Sun, 17 Mar 2019 19:35:04 +0530
Subject: [PATCH] add a sample logging.conf in docs/misc (#4380)

add a sample logging.conf in docs/misc

(and point to it in the man page)
---
 docs/misc/logging.conf     | 23 +++++++++++++++++++++++
 docs/usage_general.rst.inc |  1 +
 2 files changed, 24 insertions(+)
 create mode 100644 docs/misc/logging.conf

diff --git a/docs/misc/logging.conf b/docs/misc/logging.conf
new file mode 100644
index 000000000..be8fb9cdc
--- /dev/null
+++ b/docs/misc/logging.conf
@@ -0,0 +1,23 @@
+[loggers]
+keys=root
+
+[handlers]
+keys=logfile
+
+[formatters]
+keys=logfile
+
+[logger_root]
+level=NOTSET
+handlers=logfile
+
+[handler_logfile]
+class=FileHandler
+level=INFO
+formatter=logfile
+args=('borg.log', 'w')
+
+[formatter_logfile]
+format=%(asctime)s %(levelname)s %(message)s
+datefmt=
+class=logging.Formatter
diff --git a/docs/usage_general.rst.inc b/docs/usage_general.rst.inc
index e895a5bd2..8e79df5b6 100644
--- a/docs/usage_general.rst.inc
+++ b/docs/usage_general.rst.inc
@@ -202,6 +202,7 @@ General:
         use fqdn@uniqueid.
     BORG_LOGGING_CONF
         When set, use the given filename as INI_-style logging configuration.
+        A basic example conf can be found at ``docs/misc/logging.conf``.
     BORG_RSH
         When set, use this command instead of ``ssh``. This can be used to specify ssh options, such as
         a custom identity file ``ssh -i /path/to/private/key``. See ``man ssh`` for other options. Using