[3/3] batman-adv: Convert README to reStructuredText
Commit Message
The current format of the file is not well defined. The reStructuredText
format (as used by other batman-adv related files) has the benefit that it
is similar easy to read and write. And it allows other tools to parse the
content of the file and convert it in a sensible way to a different file
format.
Multiple git repository web-based management software also can directly
render these files as properly formatted HTML output.
Signed-off-by: Sven Eckelmann <sven@narfation.org>
---
README.external | 51 ------------------------------------------
README.external.license | 2 --
README.external.rst | 59 +++++++++++++++++++++++++++++++++++++++++++++++++
3 files changed, 59 insertions(+), 53 deletions(-)
delete mode 100644 README.external
delete mode 100644 README.external.license
create mode 100644 README.external.rst
deleted file mode 100644
@@ -1,51 +0,0 @@
-BATMAN-ADV external module
---------------------------
-
-The batman-adv module is shipped as part of the Linux kernel
-and as external module. The external module allows to get
-new features without upgrading to a newer kernel version
-and to get batman-adv specific bugfixes for kernels that are
-not supported anymore. It compiles against and should work
-with Linux 3.2 - 4.14. Supporting older versions is not
-planned, but it's probably easy to backport it. If you work on a
-backport, feel free to contact us. :-)
-
-COMPILE
--------
-
-To compile against your currently installed kernel, just type:
-
-# make
-
-if you want to compile against some other kernel, use:
-
-# make KERNELPATH=/path/to/kernel
-
-if you want to install this module:
-
-# sudo make install
-
-CONFIGURATION
--------------
-
-The in-kernel module can be configured through
-menuconfig. When compiling outside of the kernel tree, it is
-necessary to configure it using the make options. Each
-option can be set to to y (enabled), n (disabled) or m (build as
-module). Available options and their possible values are
-(default marked with an "*")
-
- * CONFIG_BATMAN_ADV_DEBUGFS=[y*|n] (B.A.T.M.A.N. debugfs entries)
- * CONFIG_BATMAN_ADV_DEBUG=[y|n*] (B.A.T.M.A.N. debugging)
- * CONFIG_BATMAN_ADV_BLA=[y*|n] (B.A.T.M.A.N. bridge loop avoidance)
- * CONFIG_BATMAN_ADV_DAT=[y*|n] (B.A.T.M.A.N. Distributed ARP Table)
- * CONFIG_BATMAN_ADV_MCAST=[y*|n] (B.A.T.M.A.N. multicast optimizations)
- * CONFIG_BATMAN_ADV_NC=[y|n*] (B.A.T.M.A.N. Network Coding)
- * CONFIG_BATMAN_ADV_BATMAN_V=[y|n*] (B.A.T.M.A.N. V routing algorithm)
-
-e.g., debugging can be enabled by
-
-# make CONFIG_BATMAN_ADV_DEBUG=y
-
-Keep in mind that all options must also be added to "make
-install" call.
deleted file mode 100644
@@ -1,2 +0,0 @@
-SPDX-License-Identifier: GPL-2.0
-License-Filename: LICENSES/preferred/GPL-2.0
new file mode 100644
@@ -0,0 +1,59 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+==========================
+BATMAN-ADV external module
+==========================
+
+Introduction
+============
+
+The batman-adv module is shipped as part of the Linux kernel
+and as external module. The external module allows to get
+new features without upgrading to a newer kernel version
+and to get batman-adv specific bugfixes for kernels that are
+not supported anymore. It compiles against and should work
+with Linux 3.2 - 4.14. Supporting older versions is not
+planned, but it's probably easy to backport it. If you work on a
+backport, feel free to contact us. :-)
+
+
+COMPILE
+=======
+
+To compile against your currently installed kernel, just type::
+
+ # make
+
+if you want to compile against some other kernel, use::
+
+ # make KERNELPATH=/path/to/kernel
+
+if you want to install this module::
+
+ # sudo make install
+
+
+CONFIGURATION
+=============
+
+The in-kernel module can be configured through
+menuconfig. When compiling outside of the kernel tree, it is
+necessary to configure it using the make options. Each
+option can be set to to y (enabled), n (disabled) or m (build as
+module). Available options and their possible values are
+(default marked with an "*")
+
+ * ``CONFIG_BATMAN_ADV_DEBUGFS=[y*|n]`` (B.A.T.M.A.N. debugfs entries)
+ * ``CONFIG_BATMAN_ADV_DEBUG=[y|n*]`` (B.A.T.M.A.N. debugging)
+ * ``CONFIG_BATMAN_ADV_BLA=[y*|n]`` (B.A.T.M.A.N. bridge loop avoidance)
+ * ``CONFIG_BATMAN_ADV_DAT=[y*|n]`` (B.A.T.M.A.N. Distributed ARP Table)
+ * ``CONFIG_BATMAN_ADV_MCAST=[y*|n]`` (B.A.T.M.A.N. multicast optimizations)
+ * ``CONFIG_BATMAN_ADV_NC=[y|n*]`` (B.A.T.M.A.N. Network Coding)
+ * ``CONFIG_BATMAN_ADV_BATMAN_V=[y|n*]`` (B.A.T.M.A.N. V routing algorithm)
+
+e.g., debugging can be enabled by::
+
+ # make CONFIG_BATMAN_ADV_DEBUG=y
+
+Keep in mind that all options must also be added to ``make install``
+call.