diff options
author | russell <russell@f38db490-d61c-443f-a65b-d21fe96a405b> | 2007-08-29 19:41:16 +0000 |
---|---|---|
committer | russell <russell@f38db490-d61c-443f-a65b-d21fe96a405b> | 2007-08-29 19:41:16 +0000 |
commit | 2149521341f36fb9f90d61796969f2665daca309 (patch) | |
tree | d328b40f0fef17003c5ac5b8c76a08b740120737 /main/event.c | |
parent | 7a00d5df42c58c7d7f70174ebeca0a8d9fc62f15 (diff) |
Try to clarify the rules on changing ast_event and ast_event_ie
git-svn-id: http://svn.digium.com/svn/asterisk/trunk@81356 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'main/event.c')
-rw-r--r-- | main/event.c | 16 |
1 files changed, 14 insertions, 2 deletions
diff --git a/main/event.c b/main/event.c index 9587212d8..45d582361 100644 --- a/main/event.c +++ b/main/event.c @@ -38,6 +38,14 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") /* Only use one thread for now to ensure ordered delivery */ #define NUM_EVENT_THREADS 1 +/*! + * \brief An event information element + * + * \note The format of this structure is important. Since these events may + * be sent directly over a network, changing this structure will break + * compatibility with older versions. However, at this point, this code + * has not made it into a release, so it is still fair game for change. + */ struct ast_event_ie { enum ast_event_ie_type ie_type:16; /*! Total length of the IE payload */ @@ -48,9 +56,13 @@ struct ast_event_ie { /*! * \brief An event * - * \note The format of this structure is important, and can not change, since - * they may be sent directly over the network. + * An ast_event consists of an event header (this structure), and zero or + * more information elements defined by ast_event_ie. * + * \note The format of this structure is important. Since these events may + * be sent directly over a network, changing this structure will break + * compatibility with older versions. However, at this point, this code + * has not made it into a release, so it is still fair game for change. */ struct ast_event { /*! Event type */ |