Give a clue about extending enums

[vlc] / include / vlc / libvlc_events.h

diff --git a/include/vlc/libvlc_events.h b/include/vlc/libvlc_events.h
index f18728ee265c01fdb9ce5f86ed73e8721fc793eb..5a0984a5e8e00e37a18b1e2c6b9fb074727f2cd8 100644 (file)
--- a/include/vlc/libvlc_events.h
+++ b/include/vlc/libvlc_events.h
@@ -45,6 +45,8 @@ extern "C" {
  */
 
 typedef enum libvlc_event_type_t {
+    /* Append new event types at the end.
+     * Do not remove, insert or re-order any entry. */
     libvlc_MediaMetaChanged,
     libvlc_MediaSubItemAdded,
     libvlc_MediaDurationChanged,
@@ -85,8 +87,8 @@ typedef enum libvlc_event_type_t {
     libvlc_MediaDiscovererEnded,
 
     libvlc_MediaPlayerTitleChanged,
-    libvlc_MediaPlayerSnapshotTaken
-
+    libvlc_MediaPlayerSnapshotTaken,
+    /* New event types HERE */
 } libvlc_event_type_t;
 
 /**