documentation overhaul (#353)

* ident
* remove $Id$ tags from rcs software which has been retired
* make an effort to sync required mib docs with actual code
* sync even more docs with what code actually does
* some whitespace nits
* fixup example to use snmpv2 for all but the most ancient devices
* remove blurb to find more specific snmp::info classes for classes
  which alrdy are as specific as they can get (eg snmp::info::layer3::vmware
  doesn't need info on to find a specific module since there ain't none)
* rename all sub {vendor} strings to lowercase vendor, if cisco, juniper
  and arista can be lowercase, so can be all the rest.
* fix tests
* spread some use warnings around
* use $ instead of @
* remove defines that are included via parent classes
* use strict + warnings
* remove alrdy included modules
* add comma after last list item
* typos
* mibs are found in our mib repo, not on the cisco site
* documentation fixes

lib/SNMP/Info/MAU.pm

@@ -1,5 +1,4 @@
 # SNMP::Info::MAU - Medium Attachment Unit - RFC 2668
-# $Id$
 #
 # Copyright (c) 2008 Max Baker changes from version 0.8 and beyond.
 #
@@ -33,6 +32,7 @@
 package SNMP::Info::MAU;
 
 use strict;
+use warnings;
 use Exporter;
 use SNMP::Info;
 
@@ -420,7 +420,7 @@ sub mau_set_i_speed_duplex_admin {
         return ("bad arguments");
     }
 
-    # map input speed and duplex paramters to 'mau_type_admin' settings
+    # map input speed and duplex parameters to 'mau_type_admin' settings
     # From IANA-MAU-MIB
     # 11 = dot3MauType10BaseTFD, 10 = dot3MauType10BaseTHD,
     # 16 = dot3MauType100BaseTXFD, 15 = dot3MauType100BaseTXHD
@@ -475,7 +475,7 @@ Max Baker
 
 SNMP::Info::MAU is a subclass of SNMP::Info that supplies access to the
 F<MAU-MIB> (RFC 2668). This MIB is sometimes implemented on Layer 2 network
-devices like HP Switches.  MAU = Medium Attachment Unit.
+devices.  MAU = Medium Attachment Unit.
 
 The MAU table contains link and duplex info for the port itself and the device
 connected to that port.
@@ -497,6 +497,8 @@ None.
 
 =item F<MAU-MIB>
 
+=item F<IANA-MAU-MIB>
+
 =back
 
 =head1 GLOBALS