Add comment about LDAPv2

diff --git a/doc/guide/admin/intro.sdf b/doc/guide/admin/intro.sdf
index 307ed288cc467a2d0f3f9a92728a2df8b6b1387d..1c8f7d281f9bb3aa3910878e1d0f41a2201bf5dc 100644 (file)
--- a/doc/guide/admin/intro.sdf
+++ b/doc/guide/admin/intro.sdf
@@ -201,9 +201,13 @@ LDAPv3 adds the following features to LDAP:
  - Schema Discovery
  - Extensibility (controls, extended operations, and more)
 
-LDAPv2 is considered historical.  As deploying both LDAPv2 and
-LDAPv3 simultaneously can be quite problematic, LDAPv2 should be
-avoided.  LDAPv2 is disabled by default.
+LDAPv2 is historic ({{REF:RFC3494}}).  As most implementations
+(including {{slapd}}(8)) of LDAPv2 do not conform to the LDAPv2
+technical specification, interoperatibility amongst implementations
+claiming LDAPv2 support will be limited.  As LDAPv2 differs
+significantly from LDAPv3, deploying both LDAPv2 and LDAPv3
+simultaneously can be quite problematic.  LDAPv2 should be avoided.
+LDAPv2 is disabled by default.
 
 
 H2: What is slapd and what can it do?

diff --git a/doc/guide/preamble.sdf b/doc/guide/preamble.sdf
index c65e4fe19042fecb567cde5ac7eea85eb25bfa05..8ed08a61f1d81ed9cd38411ecf6832e612bb66a6 100644 (file)
--- a/doc/guide/preamble.sdf
+++ b/doc/guide/preamble.sdf
@@ -221,5 +221,7 @@ RFC3088|X|OpenLDAP Root Service|ftp://ftp.isi.edu/in-notes/rfc3088.txt
 RFC3296|PS|Named Subordinate References in LDAP|ftp://ftp.isi.edu/in-notes/rfc3296.txt
 RFC3377|PS|Lightweight Directory Access Protocol (v3): Technical Specification
 RFC3383|BCP|Internet Assigned Numbers Authority (IANA) Considerations for the Lightweight Directory Access Protocol (LDAP)
-RFC3384|INFO|Lightweight Directory Access Procotol (version 3) Replication Requirements
+RFC3384|INFO|Lightweight Directory Access Protocol (version 3) Replication Requirements
+RFC3494:INFO|Lightweight Directory Access Protocol version 2 (LDAPv2) to Historic Status
+
 !endblock

diff --git a/doc/guide/release/install.sdf b/doc/guide/release/install.sdf
index de1d6b54db8289553d32b7ff02a599b03e89c953..bddbe95de438b617df5eaacd3e7bf812f783972b 100644 (file)
--- a/doc/guide/release/install.sdf
+++ b/doc/guide/release/install.sdf
@@ -46,7 +46,7 @@ determining compiler/linker options including:
 >      Variable        Description     Example
 >      CC              C compiler      gcc
 >      CFLAGS          C flags         -O -g
->      CPPFLAGS        cpp flags       -I/path/include -Ddef
+>      CPPFLAGS        cpp flags       -I/path/include -D__FOO__=42
 >      LDFLAGS         ld flags        -L/usr/local/lib
 >      LIBS            libraries       -llib
 >      PATH            command path    /usr/local/bin:/usr/bin:/bin