glib/docs/rationales.md
Philip Withnall cdb0cc8800 docs: Move README.rationale to docs subdirectory
This is part of an effort to rationalise our developer documentation a
bit, putting it all in one directory rather than cluttering up the root
directory.

Signed-off-by: Philip Withnall <pwithnall@endlessos.org>
2022-05-11 13:02:49 +01:00

718 B

This file documents various major decisions which affect GLib development, giving a brief rationale of each decision, plus a link to further discussion.

  • Compiler attributes: https://bugzilla.gnome.org/show_bug.cgi?id=113075#c46

    GLib uses GIR annotations instead of compiler attributes. They are tidier, already supported by GLib and GNOME tools, and accomplish the same task as compiler attributes. GLib does not provide macros for attributes like nonnull because it would not use them.

  • Main loop API:

    The ID-based mainloop APIs (g_idle_add, g_timeout_add, etc) are considered legacy, and new features (such as g_source_set_static_name) will only be added to the explicit GSource APIs.