Release Notes for Netomata Config Generator (NCG)
                          Version 0.10.2
                           28 Oct 2010

Changes Since Version 0.10.1
============================
Updated NCG to use the Ruby Hashery library instead of the Facets
library, because the "Dictionary" class (which NCG depends upon) was
removed from Facets as of the Facets 2.9.0 release on 1 Sep 2010.
(The Hashery library has been the preferred source of the Dictionary
class for some time, but the Dictionary class had also been included
in versions of Facets prior to 2.9.0 for historical reasons.)

Changes Since Version 0.9.1
===========================
Changed .neto file processing so that [% ... %] ERB template processing can
be used on any line, not just in "key = value" assignments.

Added new '<' .neto_table header line; see doc/formats/neto_table.html .
This is analogous to an "include" directive in a .neto file, and provides
a convenient way to apply many lines in .neto format to each line of
data in the .neto_table file (sort of like a subroutine).  For example,
the following in a list of .neto_table header lines:
	< key filename [ ... ]
tells ncg to process the .neto format file(s) named by "filename ..." in the
context of "key".  This is equivalent to the .neto format construct of
	key {
	    include filename [ ... ]
	}

Made so that a value of "-" in a .neto file assignment (for instance,
"foo = -"), or as a data value in a .neto_table file, now causes
the named key (i.e., "foo" in the previous ecample) to be ignored
(or deleted, if the key already has a value).  This provides a way
to either say "no value" for a given key, or to delete an already-set
key.

Added a Netomata::IPAddr class the extends the standard Ruby IPAddr class
by additing a variety of methods for extracting netmasks in various formats
(CIDR, IPv4 dotted quad, etc.).  See rdoc/classes/Netomata/IPAddr.html .

Added a "compare_parts" utility method, which makes it easy to sort lists
of interfaces and sub-interfaces into a "sensible" order (for instance,
so that "FastEthernet2" comes before "FastEthernet10"; in a purely alphabetic
sort, it would come after).  See the "compare_parts" section in 
rdoc/classes/Netomata/Utilities/ClassMethods.html .

Added Netomata::Node utility methods "affirm?", "each_by_subkey", and
"sort_by_subkey".  See rdoc/classes/Netomata/Node.html for more info.

Improved progress indicators when running ncg in "-v" (verbose) mode.  In
particular, progress in reading nested files is now reported more clearly.

Made debugging output, if enabled, go to STDERR rather than STDOUT.

Made various minor changes to make NCG run under Ruby 1.8.4; however, these
changes have not been extensively tested.  If you must use Ruby 1.8.4,
give this version of NCG a try and let us know how it works.  Officially,
NCG still requires Ruby 1.8.6 or later, but we'd like to know if it works
under Ruby 1.8.4, since that release is standard on many not-so-old
Fedora and Red Hat distributions.

Added new "point-to-point" example (see examples/point-to-point/README).

Updated documentation filenames (in doc/* subdirectories) to end in
.html, to clearly indicate the format of the documenation.

Included Ruby RDOC documentation for Netomata libraries, in the rdoc/*
directory.  Open file "rdoc/index.html" as a starting point.

# $Id: RELEASE_NOTES 551 2010-10-28 22:19:48Z brent $
# Copyright (C) 2008-2010 Netomata, Inc.  All Rights Reserved. 
# Please review accompanying 'LICENSE' file or
# http://www.netomata.com/docs/licenses/ncg for important notices,
# disclaimers, and license terms.