diff --git a/src/docbkx/ldif-parsing.xml b/src/docbkx/ldif-parsing.xml index 7245bbd2..1e86a554 100644 --- a/src/docbkx/ldif-parsing.xml +++ b/src/docbkx/ldif-parsing.xml @@ -7,19 +7,23 @@
Introduction - LDIF files are the standard medium for serializing directory data to - a flat file for archival, transferrence, or altercation. The - org.springframework.ldap.ldif package provides classes - needed to read LDAP objects from flat files and de-serialize them into - tangible objects. + LDAP Directory Interchange Format (LDIF) files are the standard + medium for describing directoy data in a flat file format. The most common + uses of this format include information transfer and archival. However, + the standard also defines a way to describe modifications to stored data + in a flat file format. LDIFs of this later type are typically referred to + as changetype or modify LDIFs. + - The LdifParser is the main class of the + The org.springframework.ldap.ldif package provides + classes needed to parse LDIF files and deserialize them into tangible + objects. The LdifParser is the main class of the org.springframework.ldap.ldif package and is capable of parsing files that are RFC 2849 compliant. This class reads lines from a resource and assembles them into an LdapAttributes object. The LdifParser currently ignores changetype LDIF entries as their usefulness in the - context of an application has yet to be determined. + context of an application has yet to be determined.