Improve documantion of many plugins

Specifically the configuration examples are now indented properly.

plugins/network/linux_if/linux_if

@@ -1,19 +1,31 @@
 #!/usr/bin/env python
 
 """
+=head1 NAME
+
 linux_if - munin plugin monitoring Linux network interfaces
 
+
+=head1 DESCRIPTION
+
 This is not a wildcard plugin. Monitored interfaces are controlled
 by 'include', 'exclude' in config. By default, only statically
 configured interfaces (and their sub-interfaces) are monitored.
 
 Features:
-* bonding - group bonding slave interfaces with master
-* vlans - group vlan sub-interfaces with main (dot1q trunk) interface
 
-plugin configuration:
+=over
 
-[linux_if]
+=item bonding - group bonding slave interfaces with master
+
+=item vlans - group vlan sub-interfaces with main (dot1q trunk) interface
+
+=back
+
+
+=head1 CONFIGURATION
+
+  [linux_if]
   # run plugin as root (required if you have VLAN sub-interfaces)
   user = root
 
@@ -31,22 +43,44 @@ plugin configuration:
   # default: true
   env.include_configured_if = true
 
-Include/exclude logic in detail. Interface name is matched..
-1) if matched by any exclude pattern, then exclude. Otherwise next step.
-2) if matched by any include pattern, then include, Otherwise next step.
-3) if 'include_configured_if' is true and 'ifcfg-*' file exists then include
-4) default is not to include interface in monitoring
-5) automatically include sub-interface, if the parent interface is monitored
+Include/exclude logic in detail. Interface name is matched according to the following rules:
+
+=over 4
+
+=item 1. if matched by any exclude pattern, then exclude. Otherwise next step.
+
+=item 2. if matched by any include pattern, then include, Otherwise next step.
+
+=item 3. if 'include_configured_if' is true and 'ifcfg-*' file exists then include
+
+=item 4. default is not to include interface in monitoring
+
+=item 5. automatically include sub-interface, if the parent interface is monitored
+
+=back
 
 Tested on: RHEL 6.x and clones (with Python 2.6)
 
-TODO:
-* implement 'data loaning' between graphs, removes duplicit measures
-* add support for bridging
-* configurable graph max based on interface speed
 
-MUNIN MAGIC MARKER
-#%# family=manual
+=head1 TODO
+
+=over 4
+
+=item implement 'data loaning' between graphs, removes duplicit measures
+
+=item add support for bridging
+
+=item configurable graph max based on interface speed
+
+=back
+
+
+=head1 MAGIC MARKERS
+
+ #%# family=manual
+
+
+=cut
 """
 
 __author__ = 'Brano Zarnovican'