Document a change in the semantics of event_get_struct_event_size()

diff --git a/include/event2/event.h b/include/event2/event.h
index 01d134e7b104420a3716dd293cad44771c707511..e0486695b792f5efa2183eab8fc19cd4b9aa79ce 100644 (file)
--- a/include/event2/event.h
+++ b/include/event2/event.h
@@ -605,9 +605,13 @@ void event_get_assignment(const struct event *event, struct event_base **base_ou
    Return the size of struct event that the Libevent library was compiled
    with.
 
-   This will be the same as sizeof(struct event) if you're running with the
-   same version of Libevent that your application was built with, but
+   This will be NO GREATER than sizeof(struct event) if you're running with
+   the same version of Libevent that your application was built with, but
    otherwise might not.
+
+   Note that it might be SMALLER than sizeof(struct event) if some future
+   version of Libevent adds extra buffer space to the end of struct event
+   to ensure 
  */
 size_t event_get_struct_event_size(void);