From 79933d7e835f2c9a91b69b6bb70fafb3a1e29839 Mon Sep 17 00:00:00 2001
From: Matthias Schiffer <mschiffer@universe-factory.net>
Date: Thu, 22 Aug 2019 23:04:39 +0200
Subject: [PATCH] docs: document new mesh.batman_adv.routing_algo settings for
 coexistence

---
 .../domains/alpha_centauri.conf                       | 10 ++++++++--
 docs/site-example/site.conf                           |  3 +++
 docs/user/site.rst                                    | 11 +++++++++--
 3 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/docs/multidomain-site-example/domains/alpha_centauri.conf b/docs/multidomain-site-example/domains/alpha_centauri.conf
index 4ce763c6e..822459720 100644
--- a/docs/multidomain-site-example/domains/alpha_centauri.conf
+++ b/docs/multidomain-site-example/domains/alpha_centauri.conf
@@ -21,7 +21,7 @@
     ip6 = 'fdxx:xxxx:xxxx:xxxx::xxxx',
   },
 
-  wifi24= {
+  wifi24 = {
     ap = {
       ssid = "alpha-centauri.example.org",
       channel = 1,
@@ -31,7 +31,7 @@
     },
   },
 
-  wifi5= {
+  wifi5 = {
     ap = {
       ssid = "alpha-centauri.example.org",
       channel = 44,
@@ -41,6 +41,12 @@
     },
   },
 
+  mesh = {
+    batman_adv = {
+      routing_algo = 'BATMAN_IV',
+    },
+  },
+
   mesh_vpn = {
     fastd = {
       groups = {
diff --git a/docs/site-example/site.conf b/docs/site-example/site.conf
index e518ff9e4..b30ac0403 100644
--- a/docs/site-example/site.conf
+++ b/docs/site-example/site.conf
@@ -74,6 +74,9 @@
 
   mesh = {
     vxlan = true,
+    batman_adv = {
+      routing_algo = 'BATMAN_IV',
+    },
   },
 
   -- The next node feature allows clients to always reach the node it is
diff --git a/docs/user/site.rst b/docs/user/site.rst
index 13a78dbc7..586231be6 100644
--- a/docs/user/site.rst
+++ b/docs/user/site.rst
@@ -238,8 +238,15 @@ mesh
     In addition, options specific to the batman-adv routing protocol can be set
     in the *batman_adv* section:
 
-    The optional value *routing_algo* allows to set up ``BATMAN_V`` based meshes. 
-    If unset, the routing algorithm will default to ``BATMAN_IV``.
+    The mandatory value *routing_algo* selects the batman-adv protocol variant.
+    The following values are supported:
+
+    - ``BATMAN_IV_LEGACY`` (*mesh-batman-adv-14*)
+    - ``BATMAN_IV`` (*mesh-batman-adv-15*)
+    - ``BATMAN_V`` (*mesh-batman-adv-15*)
+
+    When both *mesh-batman-adv-14* and *mesh-batman-adv-15* are included, this
+    setting specifies which one to use.
 
     The optional value *gw_sel_class* sets the gateway selection class, the
     default is ``20`` for B.A.T.M.A.N. IV and ``5000`` kbit/s for B.A.T.M.A.N. V.
-- 
GitLab