diff --git a/UPGRADING b/UPGRADING
index c909884e166..fd915a8b50f 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -477,6 +477,10 @@ PCRE:
     (`(object) array( ... )`), rather than using the nonexistent method
     stdClass::__setState().
 
+ Zip:
+  . Building against the bundled libzip is discouraged, but still possible by
+    adding `--without-libzip` to the configuration.
+
 ========================================
 10. New Global Constants
 ========================================