invalid DN/filter strings, misc. (WG last call on the Java API)

["Kurt D. Zeilenga" <Kurt@OpenLDAP.org>]

These suggestions are primarily editorial in nature:

The I-D represents a number of simple assertion filters
in the form "sn=Jensen", an invalid form.  The I-D
should use "(sn=Jensen)".

The I-D represents a number of DN in the form:
  cn=Barbara Jensen, o=University of Michigan, c=US

An LDAPv3 generated per RFC 2253, Section 2 would
have the form:
  cn=Barbara Jensen,o=University of Michigan,c=US

That is, the more restrictive RFC 2253 form, as
opposed to the RFC 1779 form, should be used.  (Yes,
I know that some of the core documents contain similar
flaws, these are being fixed).

I also recommend that examples use domains (example.com),
DNs (dc=example,dc=com) and IPv4/IPv6 addresses reserved
for examples. For IPv4, IIRC, 192.0.2.0 can be used
(though that might be TEST numbers).  For IPv6, you can
use the IPv6 over IPv4 address (2002::/16) based on the
example IPv4 addresses you use.

I also note that some examples imports "netscape.ldap", not
"org.ietf.ldap".  BTW, I couldn't find any packaging, name
space requirements for this API, nor any guide as to what
namespaces/packaging extensions to this API should be
placed in...