Add a disparaging note about use of referrals; use chaining or

database glue instead.

diff --git a/doc/guide/admin/referrals.sdf b/doc/guide/admin/referrals.sdf
index 0b41a2a355dd1d90838d417fd3b5c5b192a974e2..8756553cb885b249d931f6475da413cb4bad356d 100644 (file)
--- a/doc/guide/admin/referrals.sdf
+++ b/doc/guide/admin/referrals.sdf
@@ -132,3 +132,10 @@ or with {{ldapsearch}}(1):
 Note: the {{EX:ref}} attribute is operational and must be explicitly
 requested when desired in search results.
 
+Note: the use of referrals to construct a Distributed Directory Service is
+extremely clumsy and not well supported by common clients. If an existing
+installation has already been built using referrals, the use of the
+{{chain}} overlay to hide the referrals will greatly improve the usability
+of the Directory system. A better approach would be to use explicitly
+defined local and proxy databases in {{subordinate}} configurations to
+provide a seamless view of the Distributed Directory.