Give a clue about extending enums

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

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