--- old/src/java.naming/share/classes/javax/naming/directory/package.html 2015-08-04 13:14:42.712900576 +0300 +++ new/src/java.naming/share/classes/javax/naming/directory/package.html 2015-08-04 13:14:42.316900567 +0300 @@ -28,7 +28,7 @@ -Extends the javax.naming package to provide functionality +Extends the javax.naming package to provide functionality for accessing directory services.

@@ -47,20 +47,20 @@

The Directory Context

-The DirContext +The DirContext interface represents a directory context. It defines methods for examining and updating attributes associated with a directory object, or directory entry as it is sometimes called.

-You use getAttributes() to retrieve the attributes +You use getAttributes() to retrieve the attributes associated with a directory object (for which you supply the name). -Attributes are modified using modifyAttributes(). +Attributes are modified using modifyAttributes(). You can add, replace, or remove attributes and/or attribute values using this operation.

-DirContext also behaves as a naming context -by extending the Context interface in the javax.naming package. +DirContext also behaves as a naming context +by extending the Context interface in the javax.naming package. This means that any directory object can also provide a naming context. For example, the directory object for a person might contain @@ -69,13 +69,13 @@ such as his printers and home directory.

Searches

-DirContext contains methods for +DirContext contains methods for performing content-based searching of the directory. In the simplest and most common form of usage, the application specifies a set of attributes--possibly with specific values--to match, and submits this attribute set, to the -search() method. -There are other overloaded forms of search() +search() method. +There are other overloaded forms of search() that support more sophisticated search filters.