Update raddb/mods-available/mac2vlan

diff --git a/raddb/mods-available/mac2vlan b/raddb/mods-available/mac2vlan
index a1db803a71cddbb98daeeeda515cff2fc77ea318..6b7c1dc10543a99c2c9fc926caa6eac95727d1dd 100644 (file)
--- a/raddb/mods-available/mac2vlan
+++ b/raddb/mods-available/mac2vlan
@@ -1,15 +1,30 @@
 # -*- text -*-
 #
+# :toc:
+#
 #  $Id$
 
-#  A simple file to map a MAC address to a VLAN.
+######################################################################
+#
+#  = Mac2Vlan Module
+#
+#  The `mac2vlan` module is a simple file to map a MAC address to a VLAN.
+#
+#  The file should be in the format `<mac>,<vlan>`.
+#
+#  e.g:
+#
+#    00:01:02:03:04:05,VLAN1
+#    03:04:05:06:07:08,VLAN2
+#    00:07:0b:12:01:09,VLAN55
+#
+#  WARNING: the VLAN name cannot have spaces in it.
+#
+
 #
-#  The file should be in the format MAC,VLAN
-#  the VLAN name cannot have spaces in it, for example:
+#  ## Default instance
 #
-#      00:01:02:03:04:05,VLAN1
-#      03:04:05:06:07:08,VLAN2
-#      ...
+#  See the `passwd` module for common configuration explanation.
 #
 passwd mac2vlan {
        filename = ${modconfdir}/${.:name}/${.:instance}