(ITS#7405) Improve refint documentation

[quanah@OpenLDAP.org]

Full_Name: Quanah Gibson-Mount
Version: 2.4.32
OS: NA
URL: ftp://ftp.openldap.org/incoming/
Submission from: (NULL) (74.196.25.250)


As per debian bug#688857:

Modifications made by refint are not replicated. They neither update the
modification timestamp nor the CSN used for replication. This is serious
data loss, because the replicas gets out of sync pretty quickly. There
seems to be no way to recover from this discrepancy without doing a
complete replication.

While this seems to be known, it is not documented at all in the
man-pages related to the refint and memberof overlays. Also it violates
the principle of least surprise, because the changes are not limited to
operational attributes.