mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-10 19:36:18 +01:00
2596919c58
Add g_auto() and g_autoptr() as helpers for declaring variables with automatic cleanup. Add some macros to help types define cleanup functions for themselves. Going forward it will be an expectation that people use this macro when creating a new type, even if they do not intend to use the auto-cleanup functionality for themselves. These new macros only work on GCC and clang, which is why we resisted adding them for so long. There exist many people who are only interested in writing programs for these compilers, however, and a similar API in libgsystem has proven to be extremely popular, so let's expose this functionality to an even wider audience. We ignore deprecation warnings when emitting the free functions, which seems suspicious. The reason that we do this is not because we want to call deprecated functions, but just the opposite: sometimes the free function will be an _unref() function that is only AVAILABLE_IN newer versions, and these warnings are also implemented as deprecation warnings. https://bugzilla.gnome.org/show_bug.cgi?id=743640 |
||
|---|---|---|
| .. | ||
| gio | ||
| glib | ||
| gobject | ||
| .gitignore | ||
| AUTHORS | ||
| ChangeLog | ||
| COPYING | ||
| Makefile.am | ||
| NEWS | ||
| README | ||
This package contains the reference documentation for GLib. For more information about Glib, see: http://www.gtk.org For information about contributing to the GLib/GTK+ reference documentation project, see: http://www.gtk.org/rdp/ The GLib reference documentation is freely redistributable, see the file COPYING for details. REQUIREMENTS ============ To build the documentation, you must have the gtk-doc package installed. To rebuild the template files, you must have the current version of the GLib header files installed. BUILD ===== First, run configure to generate the makefiles for this module. There is one option specific to this package --with-html-dir=DIR top of installed HTML documentation tree The Makefiles for this module define three targets: templates: Scan the headers and merge the results with the current template files sgml: Generate SGML files using the DocBook DTD from the template files html: Generate HTML from the SGML files. To build the documentation, do: make sgml make html You should only run the 'make templates' step if you need to regenerate the templates for a more recent version of the GLib sources. INSTALLATION ============ make install