diff options
author | Chad Versace <chad.versace@intel.com> | 2015-01-04 13:35:57 -0800 |
---|---|---|
committer | Chad Versace <chad.versace@intel.com> | 2015-01-27 09:36:05 -0800 |
commit | 0542811c351e3efbbd71ef40b33cc4b6eeded7e6 (patch) | |
tree | 055351fcb44b7d9317b9142fc179ba3f8bb9cbb7 | |
parent | a235ac4bc60d7b6afea28138cd7848883b0a61a7 (diff) |
include: Deprecate waffle_attrib_list funcs
It was a mistake when I decided to make Waffle's attribute lists 32-bit.
Instead, the lists should have had type intptr_t[] to allow pointer
input-output. To correct that original mistake, I will soon introduce
some new public functions that have `intptr_t attrib_list[]` parameters.
I'm deprecating the waffle_attrib_list functionss because I don't want
to maintain two variants (int32_t and intptr_t) of each function. They
offer little utility to users, so I see little benefit in trying
maintain both variants.
Signed-off-by: Chad Versace <chad.versace@intel.com>
Tested-by: Emil Velikov <emil.l.velikov@gmail.com> (msvc/wgl)
Reviewed-by: Emil Velikov <emil.l.velikov@gmail.com>
-rw-r--r-- | include/waffle/waffle.h | 8 | ||||
-rw-r--r-- | man/waffle_attrib_list.3.xml | 14 |
2 files changed, 14 insertions, 8 deletions
diff --git a/include/waffle/waffle.h b/include/waffle/waffle.h index f4bb6ef..b19c53b 100644 --- a/include/waffle/waffle.h +++ b/include/waffle/waffle.h @@ -325,23 +325,23 @@ union waffle_native_window { // waffle_attrib_list // --------------------------------------------------------------------------- -int32_t +WAFFLE_DEPRECATED_1_06 int32_t waffle_attrib_list_length(const int32_t attrib_list[]); -bool +WAFFLE_DEPRECATED_1_06 bool waffle_attrib_list_get( const int32_t attrib_list[], int32_t key, int32_t *value); -bool +WAFFLE_DEPRECATED_1_06 bool waffle_attrib_list_get_with_default( const int32_t attrib_list[], int32_t key, int32_t *value, int32_t default_value); -bool +WAFFLE_DEPRECATED_1_06 bool waffle_attrib_list_update( int32_t *attrib_list, int32_t key, diff --git a/man/waffle_attrib_list.3.xml b/man/waffle_attrib_list.3.xml index 9b390ba..277fe26 100644 --- a/man/waffle_attrib_list.3.xml +++ b/man/waffle_attrib_list.3.xml @@ -44,19 +44,19 @@ <funcsynopsisinfo>#include <waffle.h></funcsynopsisinfo> <funcprototype> - <funcdef>bool <function>waffle_attrib_list_length</function></funcdef> + <funcdef>DEPRECATED bool <function>waffle_attrib_list_length</function></funcdef> <paramdef>const int32_t <parameter>attrib_list</parameter>[]</paramdef> </funcprototype> <funcprototype> - <funcdef>bool <function>waffle_attrib_list_get</function></funcdef> + <funcdef>DEPRECATED bool <function>waffle_attrib_list_get</function></funcdef> <paramdef>const int32_t <parameter>attrib_list</parameter>[]</paramdef> <paramdef>int32_t <parameter>key</parameter></paramdef> <paramdef>int32_t *<parameter>value</parameter></paramdef> </funcprototype> <funcprototype> - <funcdef>bool <function>waffle_attrib_list_get_with_default</function></funcdef> + <funcdef>DEPRECATED bool <function>waffle_attrib_list_get_with_default</function></funcdef> <paramdef>const int32_t <parameter>attrib_list</parameter>[]</paramdef> <paramdef>int32_t <parameter>key</parameter></paramdef> <paramdef>int32_t *<parameter>value</parameter></paramdef> @@ -64,13 +64,19 @@ </funcprototype> <funcprototype> - <funcdef>bool <function>waffle_attrib_list_update</function></funcdef> + <funcdef>DEPRECATED bool <function>waffle_attrib_list_update</function></funcdef> <paramdef>int32_t <parameter>attrib_list</parameter>[]</paramdef> <paramdef>int32_t <parameter>key</parameter></paramdef> <paramdef>int32_t *<parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> + + <refsect2> + <title>Deprecation</title> + <para>All functions above are deprecated in Waffle 1.6 and later.</para> + </refsect2> + </refsynopsisdiv> <refsect1> |