From 71ee869c025f3e1f95d7895e44f8c0aca1eacec0 Mon Sep 17 00:00:00 2001
From: Oliver Gorwits <oliver@cpan.org>
Date: Wed, 15 Nov 2017 22:14:47 +0000
Subject: [PATCH] additional doc examples

---
 lib/App/Netdisco/Manual/Configuration.pod | 13 ++++++++-----
 lib/App/Netdisco/Util/SNMP.pm             |  3 +++
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/lib/App/Netdisco/Manual/Configuration.pod b/lib/App/Netdisco/Manual/Configuration.pod
index 30fe990d..d91a6c82 100644
--- a/lib/App/Netdisco/Manual/Configuration.pod
+++ b/lib/App/Netdisco/Manual/Configuration.pod
@@ -52,8 +52,11 @@ val2} >> on one line or C<key: value> on separate lines, e.g.:
 
 =item *
 
-String - Quoted, just like in Perl (and essential if the item contains the
-colon character).
+String - Optionally quoted, just like in Perl (quotes required if the item
+contains a colon character). For example:
+
+ log: 'debug'
+ expire_devices: 15
 
 =back
 
@@ -645,11 +648,11 @@ renumbered to use that interface as its new identity and the process stops.
 When using an Access Control List for the value (interface selection), as well
 as the options described in L</"ACCESS CONTROL LISTS"> you can use
 "C<port:regexp>" to match an interface's port name. For example to renumber
-all Arista devices to the IP and host name of their Mgmt1 interface (if they
-have one), you could use:
+any device to the IP and host name of its Mgmt1 interface (if it has one), you
+could use:
 
  device_identity:
-   'vendor:arista': 'port:(?i)mgmt1'
+   'any': 'port:(?i)mgmt1'
 
 Once a device is renumbered, its new identity is "sticky". That is, you could
 remove the C<device_identity> configuration and the next "discover" job will
diff --git a/lib/App/Netdisco/Util/SNMP.pm b/lib/App/Netdisco/Util/SNMP.pm
index eeea2fa8..832cd958 100644
--- a/lib/App/Netdisco/Util/SNMP.pm
+++ b/lib/App/Netdisco/Util/SNMP.pm
@@ -188,6 +188,9 @@ sub _get_external_community {
 Takes an established L<SNMP::Info> instance and makes a fresh connection using
 community indexing, with the given C<$vlan> ID. Works for all SNMP versions.
 
+Passing VLAN "C<0>" (zero) will reset the indexing to the basic v2 community
+or v3 empty context.
+
 =cut
 
 sub snmp_comm_reindex {