Add comment about LDAPv2

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?

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

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