From 6b5ad2066a8002bb0fd1dde58e6c0f1e43613aee Mon Sep 17 00:00:00 2001
From: "Ondrej Zajicek (work)" <santiago@crfreenet.org>
Date: Wed, 12 Dec 2018 16:54:23 +0100
Subject: [PATCH] Doc: Document log rotation feature

---
 doc/bird.sgml | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/doc/bird.sgml b/doc/bird.sgml
index c0999d2d..8dc872e7 100644
--- a/doc/bird.sgml
+++ b/doc/bird.sgml
@@ -471,17 +471,25 @@ ipv6 table
 include "tablename.conf";;
 </code>
 
-	<tag><label id="opt-log">log "<m/filename/"|syslog [name <m/name/]|stderr all|{ <m/list of classes/ }</tag>
-	Set logging of messages having the given class (either <cf/all/ or
-	<cf/{ error|trace [, <m/.../] }/ etc.) into selected destination (a file specified
-	as a filename string, syslog with optional name argument, or the stderr
-	output). Classes are:
+	<tag><label id="opt-log">log "<m/filename/" [<m/limit/ "<m/backup/"] | syslog [name <m/name/] | stderr all|{ <m/list of classes/ }</tag>
+	Set logging of messages having the given class (either <cf/all/ or <cf>{
+	error|trace [, <m/.../] }</cf> etc.) into selected destination - a file
+	specified as a filename string (with optional log rotation information),
+	syslog (with optional name argument), or the stderr output.
+
+	Classes are:
 	<cf/info/, <cf/warning/, <cf/error/ and <cf/fatal/ for messages about local problems,
 	<cf/debug/ for debugging messages,
 	<cf/trace/ when you want to know what happens in the network,
 	<cf/remote/ for messages about misbehavior of remote machines,
 	<cf/auth/ about authentication failures,
 	<cf/bug/ for internal BIRD bugs.
+
+	Logging directly to file supports basic log rotation -- there is an
+	optional log file limit and a backup filename, when log file reaches the
+	limit, the current log file is renamed to the backup filename and a new
+	log file is created.
+
 	You may specify more than one <cf/log/ line to establish logging to
 	multiple destinations. Default: log everything to the system log, or
 	to the debug output if debugging is enabled by <cf/-d//<cf/-D/