diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4c7adf602..4fe3e0267 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@ This section is for changes merged to the `major` branch that are not also merge
 
 ## Deprecations
 - The `IFS` variable is deprecated and will be removed in fish 4.0 (#4156).
+- The `function --on-process-exit` event will be removed in future (#4700). Use the "fish_exit" event instead.
 
 ## Notable non-backward compatible changes
 - `.` command no longer exists -- use `source` (#4294).