- bump to 0.20slapi-nis-0.20

4 files changed, 41 insertions, 3 deletions

diff --git a/NEWS b/NEWS
index 7e772de..b023f41 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,5 @@
+0.20    * Add a deref_f function which works like deref but also applies a
+	  filter before reading the target attribute from the target entry.
 0.19    * Fix a brown-paper-bag crash.
 0.18    * Check that the search base is serviced by a real backend before
 	  we'll attempt to participate in a search request.
diff --git a/configure.ac b/configure.ac
index 3e5ddeb..298cde8 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,4 +1,4 @@
-AC_INIT(slapi-nis,0.19)
+AC_INIT(slapi-nis,0.20)
 AC_CONFIG_MACRO_DIR([m4])
 AM_INIT_AUTOMAKE(foreign)
 LT_INIT
diff --git a/doc/format-specifiers.txt b/doc/format-specifiers.txt
index ed6ef65..3e31aac 100644
--- a/doc/format-specifiers.txt
+++ b/doc/format-specifiers.txt
@@ -176,6 +176,37 @@ Because the plugin attempts to track updates, the ''THISATTRIBUTE''
 attribute should be indexed and defined with a proper syntax and
 equality test in the directory server schema.
 
+=== deref_f ===
+
+  deref_f(''THISATTRIBUTE'',''FILTER'',''THATATTRIBUTE'')
+
+Returns a list of the values of ''THATATTRIBUTE'' for directory entries
+named by this entry's ''THISATTRIBUTE'' which match ''FILTER''.  Its function
+is similar in principle to the indirect CoS functionality provided by the
+directory server.
+
+Here are some example entries:
+
+  dn: cn=group
+  member: uid=bob
+  member: uid=pete
+
+  dn: uid=bob
+  uid: bob
+
+  dn: uid=pete
+  uid: pete
+
+And here's how various expressions evaluate for ''cn=group'':
+
+  %deref("member","objectclass=*","foo") -> no values
+  %deref("member","objectclass=*","uid") -> (bob,pete)
+  %deref("member","uid=pete","uid") -> (pete)
+
+Because the plugin attempts to track updates, the ''THISATTRIBUTE''
+attribute should be indexed and defined with a proper syntax and
+equality test in the directory server schema.
+
 === deref_r ===
 
   deref_r(''ATTRIBUTE''[,''OTHERATTRIBUTE''[...]],''VALUEATTRIBUTE'')
@@ -349,7 +380,8 @@ The result list is, therefore, empty.
 
 Because the plugin attempts to track updates, every attribute used here
 (except for ''VALUEATTRIBUTE'') should be indexed and defined with a
-proper syntax and equality test in the directory server schema.
+proper syntax and equality test in the directory server schema.  This
+function can also be invoked as ''deref_fr''.
 
 === referred ===
 
diff --git a/slapi-nis.spec b/slapi-nis.spec
index f0847da..0a323fa 100644
--- a/slapi-nis.spec
+++ b/slapi-nis.spec
@@ -1,5 +1,5 @@
 Name:		slapi-nis
-Version:	0.19
+Version:	0.20
 Release:	1%{?dist}
 Summary:	NIS Server and Schema Compatibility plugins for Directory Server
 Group:		System Environment/Daemons
@@ -50,6 +50,10 @@ rm -rf $RPM_BUILD_ROOT
 %{_sbindir}/nisserver-plugin-defs
 
 %changelog
+* Tue Nov 18 2010 Nalin Dahyabhai <nalin@redhat.com> - 0.20-1
+- update to 0.20
+  - add a deref_f function
+
 * Mon Nov 17 2010 Nalin Dahyabhai <nalin@redhat.com> - 0.19-1
 - fix a brown-paper-bag crash