Give a clue about extending enums

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;
 
 /**

diff --git a/include/vlc/libvlc_structures.h b/include/vlc/libvlc_structures.h
index a1b0a7e1f8b2c670e616c383cfe5197288a7405e..49ddbbbb1924dc15a371c96ae8ab453b37bf6685 100644 (file)
--- a/include/vlc/libvlc_structures.h
+++ b/include/vlc/libvlc_structures.h
@@ -103,7 +103,8 @@ typedef enum libvlc_meta_t {
     libvlc_meta_Publisher,
     libvlc_meta_EncodedBy,
     libvlc_meta_ArtworkURL,
-    libvlc_meta_TrackID
+    libvlc_meta_TrackID,
+    /* Add new meta types HERE */
 } libvlc_meta_t;
 
 /**@} */