From: Daniel Juyung Seo <seojuyung2@gmail.com>
Date: Thu, 7 Aug 2014 16:26:47 +0000 (+0900)
Subject: widget: added warnings to internal headers.
X-Git-Tag: v1.11.0-beta2~14
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=40034a82ee5be6d4ec362d6642b2fedcf9a9cca2;p=platform%2Fupstream%2Felementary.git

widget: added warnings to internal headers.

These headers are installed in the system but not officially supported
as they are considered as internal headers.
The reason why they still need to be installed is that
   - they were exposed even in the previous releases.
   - they are needed for widget customization (unofficially)
   - or it will break ewe.

Special thanks to Stefan for the reporting.
---

diff --git a/src/lib/elm_widget_actionslider.h b/src/lib/elm_widget_actionslider.h
index d68f082..6025c7b 100644
--- a/src/lib/elm_widget_actionslider.h
+++ b/src/lib/elm_widget_actionslider.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_bg.h b/src/lib/elm_widget_bg.h
index 65ded66..e8541f7 100644
--- a/src/lib/elm_widget_bg.h
+++ b/src/lib/elm_widget_bg.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_box.h b/src/lib/elm_widget_box.h
index 29b6ed2..fa321fc 100644
--- a/src/lib/elm_widget_box.h
+++ b/src/lib/elm_widget_box.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_bubble.h b/src/lib/elm_widget_bubble.h
index a001efa..25327e2 100644
--- a/src/lib/elm_widget_bubble.h
+++ b/src/lib/elm_widget_bubble.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_button.h b/src/lib/elm_widget_button.h
index 35536c0..ca67d5a 100644
--- a/src/lib/elm_widget_button.h
+++ b/src/lib/elm_widget_button.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_calendar.h b/src/lib/elm_widget_calendar.h
index 1b442e0..b48f22f 100644
--- a/src/lib/elm_widget_calendar.h
+++ b/src/lib/elm_widget_calendar.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_check.h b/src/lib/elm_widget_check.h
index f78c98d..bcf3eac 100644
--- a/src/lib/elm_widget_check.h
+++ b/src/lib/elm_widget_check.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_clock.h b/src/lib/elm_widget_clock.h
index d4346ea..f899cf8 100644
--- a/src/lib/elm_widget_clock.h
+++ b/src/lib/elm_widget_clock.h
@@ -5,6 +5,12 @@
 
 #include <Eio.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_colorselector.h b/src/lib/elm_widget_colorselector.h
index 1c74162..8e7c547 100644
--- a/src/lib/elm_widget_colorselector.h
+++ b/src/lib/elm_widget_colorselector.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_conform.h b/src/lib/elm_widget_conform.h
index d1a09de..16a3509 100644
--- a/src/lib/elm_widget_conform.h
+++ b/src/lib/elm_widget_conform.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_container.h b/src/lib/elm_widget_container.h
index 2cf5939..a8cde24 100644
--- a/src/lib/elm_widget_container.h
+++ b/src/lib/elm_widget_container.h
@@ -3,6 +3,12 @@
 
 #include <elm_widget.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_ctxpopup.h b/src/lib/elm_widget_ctxpopup.h
index 391359a..0044a7d 100644
--- a/src/lib/elm_widget_ctxpopup.h
+++ b/src/lib/elm_widget_ctxpopup.h
@@ -3,6 +3,12 @@
 
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_datetime.h b/src/lib/elm_widget_datetime.h
index 07829c2..328e2e8 100644
--- a/src/lib/elm_widget_datetime.h
+++ b/src/lib/elm_widget_datetime.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_dayselector.h b/src/lib/elm_widget_dayselector.h
index 792e9dc..77bcb72 100644
--- a/src/lib/elm_widget_dayselector.h
+++ b/src/lib/elm_widget_dayselector.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_diskselector.h b/src/lib/elm_widget_diskselector.h
index 7f56be5..02a8863 100644
--- a/src/lib/elm_widget_diskselector.h
+++ b/src/lib/elm_widget_diskselector.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_entry.h b/src/lib/elm_widget_entry.h
index 030ec73..06b4dda 100644
--- a/src/lib/elm_widget_entry.h
+++ b/src/lib/elm_widget_entry.h
@@ -4,6 +4,12 @@
 #include "elm_interface_scrollable.h"
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_fileselector.h b/src/lib/elm_widget_fileselector.h
index cf67ecd..10acc4f 100644
--- a/src/lib/elm_widget_fileselector.h
+++ b/src/lib/elm_widget_fileselector.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_fileselector_button.h b/src/lib/elm_widget_fileselector_button.h
index aa04569..a328989 100644
--- a/src/lib/elm_widget_fileselector_button.h
+++ b/src/lib/elm_widget_fileselector_button.h
@@ -5,6 +5,12 @@
 
 #include <Eio.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_fileselector_entry.h b/src/lib/elm_widget_fileselector_entry.h
index 1c15645..5c59dfe 100644
--- a/src/lib/elm_widget_fileselector_entry.h
+++ b/src/lib/elm_widget_fileselector_entry.h
@@ -5,6 +5,12 @@
 
 #include <Eio.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_flip.h b/src/lib/elm_widget_flip.h
index daa35b0..c1140c7 100644
--- a/src/lib/elm_widget_flip.h
+++ b/src/lib/elm_widget_flip.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_flipselector.h b/src/lib/elm_widget_flipselector.h
index ce1469f..fa7ce07 100644
--- a/src/lib/elm_widget_flipselector.h
+++ b/src/lib/elm_widget_flipselector.h
@@ -3,6 +3,12 @@
 
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_frame.h b/src/lib/elm_widget_frame.h
index 0740444..6f74b24 100644
--- a/src/lib/elm_widget_frame.h
+++ b/src/lib/elm_widget_frame.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_gengrid.h b/src/lib/elm_widget_gengrid.h
index a2b94c2..b9e9485 100644
--- a/src/lib/elm_widget_gengrid.h
+++ b/src/lib/elm_widget_gengrid.h
@@ -4,6 +4,12 @@
 #include "elm_gen_common.h"
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_genlist.h b/src/lib/elm_widget_genlist.h
index 098914e..9a77872 100644
--- a/src/lib/elm_widget_genlist.h
+++ b/src/lib/elm_widget_genlist.h
@@ -4,6 +4,12 @@
 #include "elm_gen_common.h"
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_glview.h b/src/lib/elm_widget_glview.h
index fec4c82..175bdf1 100644
--- a/src/lib/elm_widget_glview.h
+++ b/src/lib/elm_widget_glview.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_grid.h b/src/lib/elm_widget_grid.h
index 9f18a1c..f646755 100644
--- a/src/lib/elm_widget_grid.h
+++ b/src/lib/elm_widget_grid.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_hover.h b/src/lib/elm_widget_hover.h
index c5afa74..1b77fcc 100644
--- a/src/lib/elm_widget_hover.h
+++ b/src/lib/elm_widget_hover.h
@@ -4,6 +4,12 @@
 #include "Elementary.h"
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_hoversel.h b/src/lib/elm_widget_hoversel.h
index 0a22961..5752414 100644
--- a/src/lib/elm_widget_hoversel.h
+++ b/src/lib/elm_widget_hoversel.h
@@ -5,6 +5,12 @@
 
 #include <Eio.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_icon.h b/src/lib/elm_widget_icon.h
index 4471a25..477a02b 100644
--- a/src/lib/elm_widget_icon.h
+++ b/src/lib/elm_widget_icon.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_image.h b/src/lib/elm_widget_image.h
index 91ccb9d..b43d656 100644
--- a/src/lib/elm_widget_image.h
+++ b/src/lib/elm_widget_image.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_index.h b/src/lib/elm_widget_index.h
index 2f3a92e..4f8a6f6 100644
--- a/src/lib/elm_widget_index.h
+++ b/src/lib/elm_widget_index.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_inwin.h b/src/lib/elm_widget_inwin.h
index 8461266..ae9ba03 100644
--- a/src/lib/elm_widget_inwin.h
+++ b/src/lib/elm_widget_inwin.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_label.h b/src/lib/elm_widget_label.h
index cd55bfa..3977034 100644
--- a/src/lib/elm_widget_label.h
+++ b/src/lib/elm_widget_label.h
@@ -5,6 +5,12 @@
 
 #include <Eio.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * Base layout smart data extended with label instance data.
  */
diff --git a/src/lib/elm_widget_layout.h b/src/lib/elm_widget_layout.h
index 1d19559..f109da6 100644
--- a/src/lib/elm_widget_layout.h
+++ b/src/lib/elm_widget_layout.h
@@ -3,6 +3,12 @@
 
 #include "elm_widget_container.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_list.h b/src/lib/elm_widget_list.h
index 51d14e6..b189bb7 100644
--- a/src/lib/elm_widget_list.h
+++ b/src/lib/elm_widget_list.h
@@ -4,6 +4,12 @@
 #include "elm_interface_scrollable.h"
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_map.h b/src/lib/elm_widget_map.h
index 0632f47..6e4408a 100644
--- a/src/lib/elm_widget_map.h
+++ b/src/lib/elm_widget_map.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_mapbuf.h b/src/lib/elm_widget_mapbuf.h
index d0f5cea..bf905a9 100644
--- a/src/lib/elm_widget_mapbuf.h
+++ b/src/lib/elm_widget_mapbuf.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_menu.h b/src/lib/elm_widget_menu.h
index 21027ed..9e6065b 100644
--- a/src/lib/elm_widget_menu.h
+++ b/src/lib/elm_widget_menu.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_multibuttonentry.h b/src/lib/elm_widget_multibuttonentry.h
index c019137..10fa22b 100644
--- a/src/lib/elm_widget_multibuttonentry.h
+++ b/src/lib/elm_widget_multibuttonentry.h
@@ -3,6 +3,12 @@
 
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_naviframe.h b/src/lib/elm_widget_naviframe.h
index e262791..cd1d813 100644
--- a/src/lib/elm_widget_naviframe.h
+++ b/src/lib/elm_widget_naviframe.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_notify.h b/src/lib/elm_widget_notify.h
index a96de32..e9ddab9 100644
--- a/src/lib/elm_widget_notify.h
+++ b/src/lib/elm_widget_notify.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_panel.h b/src/lib/elm_widget_panel.h
index 3874008..1072408 100644
--- a/src/lib/elm_widget_panel.h
+++ b/src/lib/elm_widget_panel.h
@@ -4,6 +4,12 @@
 #include "elm_interface_scrollable.h"
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_panes.h b/src/lib/elm_widget_panes.h
index be5e884..c4625aa 100644
--- a/src/lib/elm_widget_panes.h
+++ b/src/lib/elm_widget_panes.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_photo.h b/src/lib/elm_widget_photo.h
index 1142573..a4d151f 100644
--- a/src/lib/elm_widget_photo.h
+++ b/src/lib/elm_widget_photo.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_photocam.h b/src/lib/elm_widget_photocam.h
index 341d74f..82c37ea 100644
--- a/src/lib/elm_widget_photocam.h
+++ b/src/lib/elm_widget_photocam.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_player.h b/src/lib/elm_widget_player.h
index 669bd92..fd71ba4 100644
--- a/src/lib/elm_widget_player.h
+++ b/src/lib/elm_widget_player.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_plug.h b/src/lib/elm_widget_plug.h
index 8fa5a62..3f534b5 100644
--- a/src/lib/elm_widget_plug.h
+++ b/src/lib/elm_widget_plug.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_popup.h b/src/lib/elm_widget_popup.h
index 59c5efa..936f2f6 100644
--- a/src/lib/elm_widget_popup.h
+++ b/src/lib/elm_widget_popup.h
@@ -4,6 +4,12 @@
 #include "Elementary.h"
 #include "elm_widget_layout.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_prefs.h b/src/lib/elm_widget_prefs.h
index 5f43df2..728ef3d 100644
--- a/src/lib/elm_widget_prefs.h
+++ b/src/lib/elm_widget_prefs.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_progressbar.h b/src/lib/elm_widget_progressbar.h
index 8ab3072..7180920 100644
--- a/src/lib/elm_widget_progressbar.h
+++ b/src/lib/elm_widget_progressbar.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_radio.h b/src/lib/elm_widget_radio.h
index 511ff96..0243164 100644
--- a/src/lib/elm_widget_radio.h
+++ b/src/lib/elm_widget_radio.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_route.h b/src/lib/elm_widget_route.h
index 0c50a86..6c54f05 100644
--- a/src/lib/elm_widget_route.h
+++ b/src/lib/elm_widget_route.h
@@ -1,6 +1,12 @@
 #ifndef ELM_WIDGET_ROUTE_H
 #define ELM_WIDGET_ROUTE_H
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_scroller.h b/src/lib/elm_widget_scroller.h
index 8ce1641..3f264b3 100644
--- a/src/lib/elm_widget_scroller.h
+++ b/src/lib/elm_widget_scroller.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_segment_control.h b/src/lib/elm_widget_segment_control.h
index 6e07b32..8b009a1 100644
--- a/src/lib/elm_widget_segment_control.h
+++ b/src/lib/elm_widget_segment_control.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_separator.h b/src/lib/elm_widget_separator.h
index b000542..9d9af33 100644
--- a/src/lib/elm_widget_separator.h
+++ b/src/lib/elm_widget_separator.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_slider.h b/src/lib/elm_widget_slider.h
index 8054d39..731ee95 100644
--- a/src/lib/elm_widget_slider.h
+++ b/src/lib/elm_widget_slider.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_slideshow.h b/src/lib/elm_widget_slideshow.h
index 9bec68f..b81e715 100644
--- a/src/lib/elm_widget_slideshow.h
+++ b/src/lib/elm_widget_slideshow.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_spinner.h b/src/lib/elm_widget_spinner.h
index 20574d3..838f571 100644
--- a/src/lib/elm_widget_spinner.h
+++ b/src/lib/elm_widget_spinner.h
@@ -5,6 +5,12 @@
 
 #include <Eio.h>
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_table.h b/src/lib/elm_widget_table.h
index fde0a59..f446b75 100644
--- a/src/lib/elm_widget_table.h
+++ b/src/lib/elm_widget_table.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_thumb.h b/src/lib/elm_widget_thumb.h
index ac0d663..c79285c 100644
--- a/src/lib/elm_widget_thumb.h
+++ b/src/lib/elm_widget_thumb.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_toolbar.h b/src/lib/elm_widget_toolbar.h
index 60609a2..07be0c9 100644
--- a/src/lib/elm_widget_toolbar.h
+++ b/src/lib/elm_widget_toolbar.h
@@ -3,6 +3,12 @@
 
 #include "elm_interface_scrollable.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_video.h b/src/lib/elm_widget_video.h
index aedeebc..43f45cf 100644
--- a/src/lib/elm_widget_video.h
+++ b/src/lib/elm_widget_video.h
@@ -3,6 +3,12 @@
 
 #include "Elementary.h"
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{
diff --git a/src/lib/elm_widget_web.h b/src/lib/elm_widget_web.h
index 656cc60..6eceacd 100644
--- a/src/lib/elm_widget_web.h
+++ b/src/lib/elm_widget_web.h
@@ -5,6 +5,12 @@
 #include <EWebKit2.h>
 #endif
 
+/* DO NOT USE THIS HEADER UNLESS YOU ARE PREPARED FOR BREAKING OF YOUR
+ * CODE. THIS IS ELEMENTARY'S INTERNAL WIDGET API (for now) AND IS NOT
+ * FINAL. CALL elm_widget_api_check(ELM_INTERNAL_API_VERSION) TO CHECK
+ * IT AT RUNTIME.
+ */
+
 /**
  * @addtogroup Widget
  * @{