Bernhard M. Wiedemann authored May 04, 2022 and Kjell Ahlstedt committed May 05, 2022

so that `gtkmm-tutorial/index.docbook` builds in a reproducible way
in spite of indeterministic filesystem readdir order
and http://bugs.python.org/issue30461

This PR was done while working on reproducible builds for openSUSE.

ignore_deprecations is a new optional argument in _WRAP_METHOD().

If false, xmllint and xsltproc are not allowed to fetch files
over the network, and gtkmm-documentation requires the docbook5-xml
and docbook-xsl packages (Ubuntu names, can have other names in
other distros).

In Meson >= 0.61.0, gnome.yelp() can't be used on a generated
XML file. See https://github.com/mesonbuild/meson/issues/10017

The default value will be changed in future Meson releases.

Don't use deprecated python3.path() and execute(..., gui_app: ...).
Let import('python').find_installation() always find the python
installation used to run Meson.

Modify
  2.2 "Installation", "Unix and Linux"
  3.2 "Basics", "Headers and Linking"
  27.1 "Internationalization and Localization", "Preparing your project"
  30 "Recommended Techniques"
Describe building with Meson more, and building with Autotools less.

The default file encoding is platform dependent in Python.
Better specify encoding when text files are read or written.

* meson.build: Call add_dist_script() in a subproject, if
meson.version() >= 0.58.0.
* tools/meson_aux/extra-dist-cmd.py: Use MESON_PROJECT_DIST_ROOT if it
exists, else MESON_DIST_ROOT. It exists if meson.version() >= 0.58.0.

Fixes #14

Require gtkmm and giomm only if build-examples=true
or a tarball is being built.

Remove a dead link. Update some jhbuild info. Mention gnome-build-meta.

and suggest filing GitLab issues and merge requests.

Should have been done when Meson build dropped the dependence on Perl.

Chun-wei Fan authored Oct 22, 2020 and Kjell Ahlstedt committed Oct 22, 2020

Links in the patch added by Kjell Ahlstedt.
Fixes #4

* tools/tutorial/insert_example_code.py: New Python file, equivalent to
the insert_example_code.pl Perl file.

The Perl file is still used when building with Autotools.

and use 'with' in Python code when files are opened.

Fixes #12

The configuration with Autotools or Meson sets the compiler
option -DDONT_HAVE_MKFIFO=1, if mkfifo() does not exist.
Meson does not create build/config.h.
This makes life easier for those who build with their own
Makefile or CMake file or whatever.
Fixes #11

Appendix G. Wrapping C Libraries with gmmproc: Describe how the
skeletonmm project is built with Meson (was Autotools).

And add 'dist-warnings' with default value 'fatal'. It's used when a
tarball is tested by 'ninja dist' or 'meson dist'.

The bash command may not be available, e.g. in Windows.
Use python instead of bash in 'ninja examples'.

See https://mail.gnome.org/archives/gtkmm-list/2019-December/msg00014.html
Fixes #9 (Danny van Elsen)

* docs/tutorial/C/index-in.docbook: Change URLs.
* docs/tutorial/insert_example_code.pl: Don't add url_examples_branchsuffix.
The branch is not a suffix in gitlab, it's included in url_examples_base.

!7 (comment 655543)

constness isn't the issue here; rather it is the value class of the
argument of set_group(). That method needs an lvalue reference as it
modifies the Group by adding the RadioButton to it. That's why we can't
`rb2.set_group( rb1.get_group() )`. But we can store the Group returned
by get_group() in a variable and then pass that to set_group() calls.
Not that there is much reason to, given join_group(), but it works fine.

Then I got carried away and added a program listing showing it
working... which, while mostly superfluous, does provide a nice
opportunity to explain briefly that RadioButtonGroup is a handle type,
meaning that it can be declared automatically and discarded by RAII
without worrying about thusly releasing the RadioButtons from itself.
That then informs readers for the next example that creates a new Group.

This is the first use of either "lvalue" or "rvalue" in the docbook!
That's either a good thing or a slippery, slippery slope to start on...

!6

The 2nd example seems to have been trying to be like the 1st, which put
the 3 RadioButtons in a subclass of Window, for no real reason since
they were never then added to said Window... but the 2nd omitted to
declare its members and instead declared new local variables in the
constructor with m_ prefixes, which were managed unlike the 1st example!

Just drop all of that. There's no clear reason to use a containing class
here. By not doing so, we can present both examples in a comparable way.

!6

Instead, recommend an std::unique_ptr, which will destroy it via RAII,
rather than requiring that the user remember to `delete` it and have to
define a non-trivial destructor just to do that, which is just busywork.

!7

…2.62, which as of Kjell’s simply epic recent commits, now supports us
setting custom properties of gtkmm-derived widgets in .ui files for
Builder. Also, slightly elaborate the bit about why you would want to!

I also be optimistic here and presume that such properties could be made
editable in Glade by using a custom catalog and property classes,
though my Glade-fu is weak, so I can only hope I'm inferring that right.

!5

Print a message to stderr when a file can't be opened.

step1/exampleapp.desktop was renamed to exampleapp.desktop.in in the
previous commit, but the filename was not changed everywhere.