Commit 0542811c authored by Chad Versace's avatar Chad Versace

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: default avatarChad Versace <chad.versace@intel.com>
Tested-by: Emil Velikov <emil.l.velikov@gmail.com> (msvc/wgl)
Reviewed-by: Emil Velikov's avatarEmil Velikov <emil.l.velikov@gmail.com>
parent a235ac4b
...@@ -325,23 +325,23 @@ union waffle_native_window { ...@@ -325,23 +325,23 @@ union waffle_native_window {
// waffle_attrib_list // waffle_attrib_list
// --------------------------------------------------------------------------- // ---------------------------------------------------------------------------
int32_t WAFFLE_DEPRECATED_1_06 int32_t
waffle_attrib_list_length(const int32_t attrib_list[]); waffle_attrib_list_length(const int32_t attrib_list[]);
bool WAFFLE_DEPRECATED_1_06 bool
waffle_attrib_list_get( waffle_attrib_list_get(
const int32_t attrib_list[], const int32_t attrib_list[],
int32_t key, int32_t key,
int32_t *value); int32_t *value);
bool WAFFLE_DEPRECATED_1_06 bool
waffle_attrib_list_get_with_default( waffle_attrib_list_get_with_default(
const int32_t attrib_list[], const int32_t attrib_list[],
int32_t key, int32_t key,
int32_t *value, int32_t *value,
int32_t default_value); int32_t default_value);
bool WAFFLE_DEPRECATED_1_06 bool
waffle_attrib_list_update( waffle_attrib_list_update(
int32_t *attrib_list, int32_t *attrib_list,
int32_t key, int32_t key,
......
...@@ -44,19 +44,19 @@ ...@@ -44,19 +44,19 @@
<funcsynopsisinfo>#include &lt;waffle.h&gt;</funcsynopsisinfo> <funcsynopsisinfo>#include &lt;waffle.h&gt;</funcsynopsisinfo>
<funcprototype> <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> <paramdef>const int32_t <parameter>attrib_list</parameter>[]</paramdef>
</funcprototype> </funcprototype>
<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>const int32_t <parameter>attrib_list</parameter>[]</paramdef>
<paramdef>int32_t <parameter>key</parameter></paramdef> <paramdef>int32_t <parameter>key</parameter></paramdef>
<paramdef>int32_t *<parameter>value</parameter></paramdef> <paramdef>int32_t *<parameter>value</parameter></paramdef>
</funcprototype> </funcprototype>
<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>const int32_t <parameter>attrib_list</parameter>[]</paramdef>
<paramdef>int32_t <parameter>key</parameter></paramdef> <paramdef>int32_t <parameter>key</parameter></paramdef>
<paramdef>int32_t *<parameter>value</parameter></paramdef> <paramdef>int32_t *<parameter>value</parameter></paramdef>
...@@ -64,13 +64,19 @@ ...@@ -64,13 +64,19 @@
</funcprototype> </funcprototype>
<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>attrib_list</parameter>[]</paramdef>
<paramdef>int32_t <parameter>key</parameter></paramdef> <paramdef>int32_t <parameter>key</parameter></paramdef>
<paramdef>int32_t *<parameter>value</parameter></paramdef> <paramdef>int32_t *<parameter>value</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
<refsect2>
<title>Deprecation</title>
<para>All functions above are deprecated in Waffle 1.6 and later.</para>
</refsect2>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1> <refsect1>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment