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.