-\item[KADM5_API_VERSION_1] Also called OVSEC_KADM_API_VERSION_1. The
-initial version of this API, written by OpenVision Technologies and
-donated to MIT for including in the public release.
+\item[KADM5_API_VERSION_1] The initial version of this API, written by
+OpenVision Technologies and donated to MIT for including in the public
+release. Originally called OVSEC_KADM_API_VERSION_1. Most everything
+has been renamed in one way or another, including functions, header
+files, and data structures. Where possible, the old OVSEC_KADM names
+have been left behind for compatibility with version 1, and
+KADM5_API_VERSION_1 is compatible with OVSEC_KADM_API_VERSION_1 at
+compile-, link-, and run-time.
+
+The OVSEC_KADM name compatibility will not be extended to new
+functionality in future versions because no existing OVSEC_KADM
+clients will use that functionality; new clients should be written to
+the KADM5 API.