update release notes

Changes

@@ -1,12 +1,12 @@
-2.035999_001 - 2017-05-17
+2.035999_002 - 2017-05-27
 
   [NEW FEATURES]
 
-  * new ACL features including AND and negation
+  * site_local_files setting for easy lib/template/static-file override
-  * named ACLs which can be used in other ACLs or *_only/*_no settings
+  * support for device identity steering via device_identity
-  * template_paths setting to allow very easy override of code and templates
+  * new ACL features: AND and negation
-  * site_local_files setting for easy lib/template override (TODO: docs)
+  * named host groups which can be used in other ACLs or *_only/*_no settings
-  * support for device identity steering via device_identity (TODO: docs)
+  * template_paths setting to allow very easy override of templates
 
   [ENHANCEMENTTS]
 

lib/App/Netdisco/Manual/Configuration.pod

@@ -661,6 +661,9 @@ very specific matching on devices, use a host group of several properties
 together with the "C<op:and>" modifier to require that all items in the list
 match the device (as in the example above).
 
+Note also that whatever interface you select as canonical for the device must
+be reachable by SNMP. This is tested and the renumber aborted if not possible.
+
 =head3 C<mibhome>
 
 Value: Directory. Default: C<${HOME}/netdisco-mibs>.

lib/App/Netdisco/Manual/ReleaseNotes.pod

@@ -35,27 +35,57 @@ deploy script for App::Netdisco will make some schema changes to the database,
 but they are backwards compatible.
 
 =back
+
 =head1 2.036000
 
-=head2 Health Advice
+This release has many significant new features and changes. Please read all
+the release notes before upgrading.
 
-In this release the apps C<netdisco-daemon> and C<netdisco-daemon-fg> have
+=over 4
+
+=item *
+
+The C<netdisco-daemon> and C<netdisco-daemon-fg> scripts have
 been renamed to C<netdisco-backend> and C<netdisco-backend-fg> respectively.
 
-This better reflects the function of the two programs. If you still have
+The old commands will still work but we recommend packagers to use the new
-scripts using C<netdisco-daemon> or C<netdisco-daemon-fg> commands, they
+names to remain consistent with documentation. Run the following on upgrade:
-should continue to work, as these apps still exist and simply exec() to the
-new scripts on start.
-
-However, it would be best if you replace any custom management config to
-point to the new app names, going forward. Remember to do this on upgrade:
 
  ln -s ~/perl5/bin/{localenv,netdisco-*} ~/bin/
 
-=head2 General Notices
+=item *
 
-This release builds a Perl SSL interface which requires OpenSSL development
+The topology import script (C<nd-import-topology>) will now queue a "discover"
-files (headers) on your system.
+job for each new device it imports.
+
+=item *
+
+A new setting C<site_local_files> is a shorthand for confguring paths in which
+to install local Perl, template, javascript, and images files for overriding
+or enhancing Netdisco. See L<App::Netdisco::Manual::Configuration> for
+details.
+
+=item *
+
+Documentation and support for access control lists has been overhauled. Most
+"C<*_no>", "C<*_only>", and "C<only>" settings will accept ACLs as single
+items or lists. ACLs now support negation and OR/AND modifier options.
+
+=item *
+
+A new setting C<host_groups> allows for creating named Access Control Lists
+which can be referred to in other host groups or in any of the settings taking
+an ACL.
+
+=item *
+
+The new setting C<device_identity> allows configuring rules to select the
+interface to use as a canonical (friendly) identity of a device in Netdisco.
+
+=item *
+
+SSL library headers are required to build Netdisco now that we retrieve
+support files via HTTPS.
 
 On Ubuntu/Debian: