1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
# gtkmm
This is gtkmm, the C++ API for GTK.
# General information
gtkmm-3.0 and gtkmm-4.0 are different parallel-installable ABIs.
This file describes gtkmm-3.0.
Web site
- https://gtkmm.gnome.org
Download location
- https://download.gnome.org/sources/gtkmm
Reference documentation
- https://gnome.pages.gitlab.gnome.org/gtkmm
The documentation on the web describes gtkmm-4.0.
If you want documentation of gtkmm-3.0, download a tarball.
Tarballs contain reference documentation. In tarballs generated with Meson,
see the untracked/docs/reference/html directory.
Discussion on GNOME's discourse forum
- https://discourse.gnome.org/tag/cplusplus
- https://discourse.gnome.org/c/platform
Git repository
- https://gitlab.gnome.org/GNOME/gtkmm
Bugs can be reported to
- https://gitlab.gnome.org/GNOME/gtkmm/issues
Patches can be submitted to
- https://gitlab.gnome.org/GNOME/gtkmm/merge_requests
# Building
Whenever possible, you should use the official binary packages approved by the
supplier of your operating system, such as your Linux distribution.
## Building on Windows
See [README.win32](README.win32.md)
## Building from a release tarball
Extract the tarball and go to the extracted directory:
```
$ tar xf gtkmm-@GTKMM_VERSION@.tar.xz
$ cd gtkmm-@GTKMM_VERSION@
```
It's easiest to build with Meson, if the tarball was made with Meson,
and to build with Autotools, if the tarball was made with Autotools.
Then you don't have to use maintainer-mode.
How do you know how the tarball was made? If it was made with Meson,
it contains files in untracked/gdk/gdkmm/, untracked/gtk/gtkmm/ and
other subdirectories of untracked/.
### Building from a tarball with Meson
Don't call the builddir 'build'. There is a directory called 'build' with
files used by Autotools.
```
$ meson setup --prefix /some_directory --libdir lib your_builddir .
$ cd your_builddir
```
If the tarball was made with Autotools, you must enable maintainer-mode:
```
$ meson configure -Dmaintainer-mode=true
```
Then, regardless of how the tarball was made:
```
$ ninja
$ ninja install
```
You can run the tests like so:
```
$ ninja test
```
### Building from a tarball with Autotools
If the tarball was made with Autotools:
```
$ ./configure --prefix=/some_directory
```
If the tarball was made with Meson, you must enable maintainer-mode:
```
$ ./autogen.sh --prefix=/some_directory
```
Then, regardless of how the tarball was made:
```
$ make
$ make install
```
You can build the examples and tests, and run some of the tests, like so:
```
$ make check
```
## Building from git
Building from git can be difficult so you should prefer building from
a release tarball unless you need to work on the gtkmm code itself.
jhbuild can be a good help
- https://gitlab.gnome.org/GNOME/jhbuild
- https://wiki.gnome.org/Projects/Jhbuild
- https://gnome.pages.gitlab.gnome.org/jhbuild
### Building from git with Meson
Maintainer-mode is enabled by default when you build from a git clone.
Don't call the builddir 'build'. There is a directory called 'build' with
files used by Autotools.
```
$ meson setup --prefix /some_directory --libdir lib your_builddir .
$ cd your_builddir
$ ninja
$ ninja install
```
You can run the tests like so:
```
$ ninja test
```
You can create a tarball like so:
```
$ ninja dist
```
### Building from git with Autotools
```
$ ./autogen.sh --prefix=/some_directory
$ make
$ make install
```
You can build the examples and tests, and run some of the tests, like so:
```
$ make check
```
You can create a tarball like so:
```
$ make distcheck
```
or
```
$ make dist
```
|
