Commit e66f91b34b for openssl.org

commit e66f91b34b53d4e301d5bade83a441d74a6a7ad5
Author: Neil Horman <nhorman@openssl.org>
Date:   Fri Sep 4 13:07:28 2026 -0400

    Augment docs for BIO_s_dgram_pair

    Reviewed-by: Jakub Zelenka <jakub.zelenka@openssl.foundation>
    Reviewed-by: Andrew Dinh <andrewd@openssl.org>
    MergeDate: Fri Sep 11 20:51:01 2026
    (Merged from https://github.com/openssl/openssl/pull/32498)

diff --git a/doc/man3/BIO_s_dgram_pair.pod b/doc/man3/BIO_s_dgram_pair.pod
index 4d7dc8d5ac..0df30f0099 100644
--- a/doc/man3/BIO_s_dgram_pair.pod
+++ b/doc/man3/BIO_s_dgram_pair.pod
@@ -55,7 +55,10 @@ The two BIOs must both use the method returned by BIO_s_dgram_pair() and neither
 of the BIOs may currently be associated in a pair.

 L<BIO_destroy_bio_pair(3)> destroys the association between two connected BIOs.
-Freeing either half of the pair will automatically destroy the association.
+Freeing either half of the pair will automatically destroy the association.  This
+destruction is implied if L<BIO_free(3)> is used to free one half of a BIO pair.
+Note that the other half of the BIO pair in such a situation may be joined to a
+new BIO, but only after calling L<BIO_destroy_bio_pair(3)> on itself.

 L<BIO_reset(3)> clears any data in the write buffer of the given BIO. This means
 that the opposite BIO in the pair will no longer have any data waiting to be