Merge branch 'backports-to-glib-2-82' into 'glib-2-82'

Various small backports to glib-2-82

See merge request GNOME/glib!4213

docs/macros.md

@@ -61,6 +61,10 @@ Quite a bit of additional debugging code is compiled into GLib when this
 macro is defined, and since it is a globally visible define, third-party code
 may be affected by it similarly to `G_DISABLE_ASSERT`.
 
+Some of these checks can be relatively expensive at runtime, as they affect
+every GObject type cast. Distributions are recommended to disable
+`G_ENABLE_DEBUG` in stable release builds.
+
 The additional code executed/compiled for this macro currently includes the
 following, but this is not an exhaustive list:
  - extra validity checks for `GDate`

gio/gmenumodel.c

@@ -50,6 +50,8 @@
  *
  * ![](menu-example.png)
  *
+ * While this kind of deeply nested menu is no longer considered good UI
+ * practice, it serves as a good example of the concepts in `GMenuModel`.
  * There are 8 ‘menus’ visible in the screenshot: one menubar, two
  * submenus and 5 sections:
  *

meson.build

@@ -677,7 +677,7 @@ functions = [
   'copy_file_range',
   'endmntent',
   'endservent',
-  'epoll_create',
+  'epoll_create1',
   'fallocate',
   'fchmod',
   'fchown',

meson.options

@@ -115,21 +115,21 @@ option('oss_fuzz',
 
 option('glib_debug',
        type : 'feature',
-       value : 'auto',
+       value : 'enabled',
        yield : true,
-       description : 'Enable GLib debug infrastructure (see docs/macros.txt)')
+       description : 'Enable GLib debug infrastructure (distros typically want this disabled in production; see docs/macros.md)')
 
 option('glib_assert',
        type : 'boolean',
        value : true,
        yield : true,
-       description : 'Enable GLib assertion (see docs/macros.txt)')
+       description : 'Enable GLib assertion (see docs/macros.md)')
 
 option('glib_checks',
        type : 'boolean',
        value : true,
        yield : true,
-       description : 'Enable GLib checks such as API guards (see docs/macros.txt)')
+       description : 'Enable GLib checks such as API guards (see docs/macros.md)')
 
 option('libelf',
        type : 'feature',