It's the latest glibmm version in the glibmm-2.4 ABI series.
This ABI series is compatible with gtkmm3.

Clarify that user sometimes must delete if managed [gtkmm-3-22]

See merge request !3

container.ccg remembers whether the object was originally un-floated by
Gtk::manage() and, if so, restores that state during Container.remove(),
with the result that the removed widget is *not* deleted, as it would be
in GTK+, but instead it is re-floated and requires the user to deal with
(e.g. to add it to some other container or to finally call delete on it)

This is documented in container.hg but nowhere that I can see in our
tutorial, and I think it is worth mentioning here, since it is not
completely intuitive: users might otherwise think that the fact manage()
delegates lifetime management to the Container means they get back the
same behaviour of C widgets, i.e. that remove() would cause destruction,
but of course that is not the case, and we might thus encourage leaks.

So mention that manage() only relieves the user of the burden of calling
delete if they add the widget to a parent and do not remove it later, in
both the Memory Management section and the part about deleting wrappers.

Fixes #2

Thanks to Kjell for pointing this out.

https://bugzilla.gnome.org/show_bug.cgi?id=792482#c10

Yikes! That’s not C++.

Sharing these between models is highly desirable as it can avoid a lot
of work and waste. So, take the para warning about not making static
ColumnRecords, and reword it to explain why you probably wanted a static
one and what the real solution is.

https://bugzilla.gnome.org/show_bug.cgi?id=792482

There are situations when the user is responsible for deleting
the wrap() result. Bug 788646

Daniel Boles authored Oct 07, 2017 and Kjell Ahlstedt committed Nov 15, 2017

Make it clear that wrap() returns a pointer to an instance owned by
glibmm, so users should not try to delete it. Also mention the effect on
refcount, i.e. nothing if (!take_copy). Finally, show the C++ instance
actually being used (though a better example would show more advantage).

While here, I split the long paragraphs for readability & to help git, &
add some missing <classname>/<function> tags for readability/semantics.

https://bugzilla.gnome.org/show_bug.cgi?id=788646

* examples/book/buildapp/Makefile.am: Fix the build of resources.c in
steps 8 and 9.
* examples/book/buildapp/README: Describe how to make the application
find the saved preferences.

Replace the link to Openismus with links to GNU's documentation of
autoconf and automake. Bug 777879

In preparation for future releases that will be compatible with the
ABI-breaking gtkmm-4.0 and glibmm-2.52, let the links from the generated
html files point to gtkmm 3.22 and glibmm 2.50 instead of the usual latest
unstable documentation and git's master branch. Bug 773642 comment 4.

* examples/book/menus/popup/examplewindow.cc:
* examples/book/treeview/popup/treeview_withpopup.cc: Replace the deprecated
Menu::popup() by the new Menu::popup_at_pointer().
* examples/others/cellrenderercustom/cellrenderertoggle.cc: Don't use an
anonymous namespace. gcc 6.2.0 reports errors because there are unused
functions. (I don't want to remove them. I suppose someone has planned to
use them some time.)

* docs/tutorial/C/index-in.docbook:
* examples/book/buildapp/step5/exampleappprefs.cc:
* examples/book/buildapp/step[5-9]/exampleappwindow.cc:
Use Gio::Settings::bind(key, property_proxy, flags) instead of
Gio::Settings::bind(key, object, property_name, flags). Better compile-time
checking and no need for the ugly tag.operator->(). Bug #772391

* docs/tutorial/C/index-in.docbook: Add sections 7-9 of the "Building
applications" chapter. It's a C++/gtkmm version of a chapter in the gtk+
documentation.
* docs/tutorial/C/figures/buildapp_*.png: 3 new files. Update the old files.
* docs/tutorial/Makefile.am: Add new image files.
* examples/book/buildapp/.gitignore: Ignore gschemas.compiled.
* examples/book/buildapp/Makefile.am: Add files in step[7-9].
* examples/book/buildapp/step[7-9]: New directories with many new files.
Bug #772391

* docs/tutorial/C/index-in.docbook: Add sections 4-6 of the "Building
applications" chapter. It's a C++/gtkmm version of a chapter in the gtk+
documentation.
* docs/tutorial/C/figures/buildapp_*.png: 3 new files.
* docs/tutorial/Makefile.am: Add new image files.
* configure.ac: Add GLIB_GSETTINGS.
* examples/Makefile.am: Don't distribute resources.c files.
* examples/book/buildapp/Makefile.am: Add files in step[4-6].
* examples/book/buildapp/step[1-2]/Makefile.example: Improved
* examples/book/buildapp/step[4-6]: New directories with many new files.
Bug #772391

Should have been included in the previous commit.

* docs/tutorial/C/index-in.docbook: Add the first 3 sections of the "Building
applications" chapter. It's a C++/gtkmm version of a chapter in the gtk+
documentation.
* docs/tutorial/C/figures/buildapp_*.png: New files.
* docs/tutorial/Makefile.am: Add new image files.
* configure.ac: Add examples/book/buildapp/Makefile.
* examples/Makefile.am: Call Makefile in the book/buildapp directory.
* examples/book/buildapp/*: New directory with many new files.
Bug #772391

It is not used. gtkmm-documentation uses mm-ax_cxx_compile_stdcxx.m4, copied
from mm-common.

* docs/tutorial/C/index-in.docbook: RadioButton section: Describe join_group().
* examples/book/buttons/radiobutton/radiobuttons.cc:
* examples/book/keyboard_events/simple/examplewindow.cc: Use join_group().
Bug #769374

So we can use some nicer features in our example code.

* docs/tutorial/C/index-in.docbook: Mention that Gtk::ActionGroup,
Gtk::*Action, Gtk::UIManager and Gtk::Activatable are now deprecated.

* docs/tutorial/C/index-in.docbook: Add aboutdialog.gresource.xml to the
listed source code files.
* examples/.gitignore: Ignore book/dialogs/aboutdialog/resources.c.
* examples/Makefile.am: Make a resource file for the AboutDialog example.
* examples/book/dialogs/aboutdialog/examplewindow.cc: Add a logotype to
the dialog.
* examples/book/dialogs/aboutdialog/aboutdialog.gresource.xml: New file.
* examples/book/dialogs/aboutdialog/gtkmm_logo.gif: New file. Copied from
gtkmm/docs/images/gtkmm_logo.gif.

* configure.ac: Pass yes to AM_SILENT_RULES, thus enabling silent builds.
Replace MM_AX_CXX_COMPILE_STDCXX_11 by MM_AX_CXX_COMPILE_STDCXX (not necessary
for silent builds). Bug #768797

* examples/MakeFile.am: Add book/listmodel.
* examples/book/listmodel/main.cc:
* examples/book/listmodel/examplewindow.[h|cc]:
* examples/book/listmodel/myobject.[h|cc]: New files.
This example is similar to gtk+/tests/listmodel.c. Bug #755149

_CUSTOM_WRAP_FUNCTION and _NO_WRAP_FUNCTION can now be used also in
a _CLASS_GTKOBJECT. Add that info to "The .hg and .ccg files" section.
Bug #767951

Before GtkUIManager was deprecated, the printing/simple and printing/advanced
examples had a toolbar and more menu items. Add them again.
Make main.cc and examplewindow.[h|cc] identical in these two examples.

Replace calls to Gdk::Window::create_cairo_context() by Gdk::Window::
begin_draw_frame() and Gdk::DrawingContext::get_cairo_context().

Move the description of this gmmproc macro to the "Macros that suppress
generation of some code" section, and make it similar to the other
descriptions there.

* examples/others/arrow/arrow.cc: Use pan-[up,down,start,end]-symbolic
* examples/others/cellrenderercustom/popupentry.cc: Use pan-down-symbolic
These icons have been around for about two years now. They should be
available in most systems.