From 389df9735204d67be248b658850c51d4a80e94dc Mon Sep 17 00:00:00 2001
From: Sebastian <versat@users.noreply.github.com>
Date: Sun, 30 Jun 2019 21:16:45 +0200
Subject: [PATCH] gtk.cfg: Add/improve g_ascii_*() functions (#1927)

* gtk.cfg: Add/improve g_ascii_*() functions

Found via daca@home

* gtk.cfg: Add `<const/>` where applicable (forgotten in last commit)

* gtk.cfg: Add `<valid>0:255</valid>` for `gchar` ASCII value arguments
---
 cfg/gtk.cfg | 278 ++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 271 insertions(+), 7 deletions(-)

diff --git a/cfg/gtk.cfg b/cfg/gtk.cfg
index d9173308a..5693f908c 100644
--- a/cfg/gtk.cfg
+++ b/cfg/gtk.cfg
@@ -1663,9 +1663,18 @@
     <leak-ignore/>
     <noreturn>false</noreturn>
   </function>
+  <!-- gint g_ascii_digit_value(gchar c); -->
   <function name="g_ascii_digit_value">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="gint"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
   </function>
   <function name="g_ascii_dtostr">
     <leak-ignore/>
@@ -1675,37 +1684,292 @@
     <leak-ignore/>
     <noreturn>false</noreturn>
   </function>
+  <!-- gboolean g_ascii_isalnum(gchar c); -->
+  <function name="g_ascii_isalnum">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isalpha(gchar c); -->
+  <function name="g_ascii_isalpha">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_iscntrl(gchar c); -->
+  <function name="g_ascii_iscntrl">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isdigit(gchar c); -->
+  <function name="g_ascii_isdigit">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isgraph(gchar c); -->
+  <function name="g_ascii_isgraph">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_islower(gchar c); -->
+  <function name="g_ascii_islower">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isprint(gchar c); -->
+  <function name="g_ascii_isprint">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_ispunct(gchar c); -->
+  <function name="g_ascii_ispunct">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isspace(gchar c); -->
+  <function name="g_ascii_isspace">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isupper(gchar c); -->
+  <function name="g_ascii_isupper">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gboolean g_ascii_isxdigit(gchar c); -->
+  <function name="g_ascii_isxdigit">
+    <noreturn>false</noreturn>
+    <returnValue type="gboolean"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
+  </function>
+  <!-- gint g_ascii_strcasecmp(const gchar *s1, const gchar *s2); -->
   <function name="g_ascii_strcasecmp">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="gint"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-null/>
+      <not-uninit/>
+    </arg>
+    <arg nr="2" direction="in">
+      <not-null/>
+      <not-uninit/>
+      <not-bool/>
+    </arg>
   </function>
+  <!-- gchar * g_ascii_strdown(const gchar *str, gssize len); -->
+  <function name="g_ascii_strdown">
+    <noreturn>false</noreturn>
+    <returnValue type="gchar *"/>
+    <use-retval/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+    </arg>
+    <arg nr="2" direction="in">
+      <not-uninit/>
+      <not-bool/>
+    </arg>
+  </function>
+  <!-- gint g_ascii_strncasecmp(const gchar *s1, const gchar *s2, gsize n); -->
   <function name="g_ascii_strncasecmp">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="gint"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+    </arg>
+    <arg nr="2" direction="in">
+      <not-uninit/>
+    </arg>
+    <arg nr="3" direction="in">
+      <not-uninit/>
+      <not-bool/>
+    </arg>
   </function>
+  <!-- gdouble g_ascii_strtod(const gchar *nptr, gchar **endptr); -->
   <function name="g_ascii_strtod">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="gdouble"/>
+    <leak-ignore/>
+    <arg nr="1" direction="in">
+      <not-null/>
+      <not-uninit/>
+      <strz/>
+    </arg>
+    <arg nr="2" direction="out"/>
   </function>
+  <!-- gint64 g_ascii_strtoll(const gchar *nptr, gchar **endptr, guint base); -->
   <function name="g_ascii_strtoll">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="gint64"/>
+    <leak-ignore/>
+    <arg nr="1" direction="in">
+      <not-null/>
+      <not-uninit/>
+      <strz/>
+    </arg>
+    <arg nr="2" direction="out"/>
+    <arg nr="3" direction="in">
+      <not-uninit/>
+      <valid>0,2:36</valid>
+    </arg>
   </function>
+  <!-- guint64 g_ascii_strtoull(const gchar *nptr, gchar **endptr, guint base); -->
   <function name="g_ascii_strtoull">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="guint64"/>
+    <leak-ignore/>
+    <arg nr="1" direction="in">
+      <not-null/>
+      <not-uninit/>
+      <strz/>
+    </arg>
+    <arg nr="2" direction="out"/>
+    <arg nr="3" direction="in">
+      <not-uninit/>
+      <valid>0,2:36</valid>
+    </arg>
   </function>
+  <!-- gchar * g_ascii_strup(const gchar *str, gssize len); -->
+  <function name="g_ascii_strup">
+    <noreturn>false</noreturn>
+    <returnValue type="gchar *"/>
+    <use-retval/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+    </arg>
+    <arg nr="2" direction="in">
+      <not-uninit/>
+      <not-bool/>
+    </arg>
+  </function>
+  <!-- gchar g_ascii_tolower(gchar c); -->
   <function name="g_ascii_tolower">
     <leak-ignore/>
     <noreturn>false</noreturn>
+    <use-retval/>
+    <returnValue type="gchar"/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
   </function>
+  <!-- gchar g_ascii_toupper(gchar c); -->
   <function name="g_ascii_toupper">
     <leak-ignore/>
     <noreturn>false</noreturn>
+    <use-retval/>
+    <returnValue type="gchar"/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
   </function>
+  <!-- gint g_ascii_xdigit_value(gchar c); -->
   <function name="g_ascii_xdigit_value">
-    <leak-ignore/>
     <noreturn>false</noreturn>
+    <returnValue type="gint"/>
+    <use-retval/>
+    <leak-ignore/>
+    <const/>
+    <arg nr="1" direction="in">
+      <not-uninit/>
+      <not-bool/>
+      <valid>0:255</valid>
+    </arg>
   </function>
   <function name="g_assert_warning">
     <leak-ignore/>