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
|
# libsigc++ : The Typesafe Callback Framework for C++
## Introduction
libsigc++ implements a typesafe callback system for standard C++. It
allows you to define signals and to connect those signals to any
callback function, either global or a member function, regardless of
whether it is static or virtual.
libsigc++ is used by gtkmm to wrap the GTK+ signal system. It does not
depend on GTK+ or gtkmm.
See the [libsigc++ web site](https://libsigcplusplus.github.io/libsigcplusplus/)
## License
Distribution of library and components is under the LGPL as listed in the
file COPYING. Examples and tests are Public Domain.
## Compatibility
Compatible compilers must support C++17, such as the decltype(auto) specifier
(from C++14) and std::invoke().
## Build
Whenever possible, you should use the official binary packages approved by the
supplier of your operating system, such as your Linux distribution. For
instance, Ubuntu Linux, Debian Linux and Fedora Linux have official libsigc++
packages.
## Building from a release tarball
Building from the [libsigc++ release tarball](https://github.com/libsigcplusplus/libsigcplusplus/releases) is easier than building from git.
### Building from a tarball with Meson
For instance:
```sh
$ meson --prefix /usr/local --libdir lib yourbuilddir .
$ cd yourbuilddir
$ ninja
$ ninja install
```
### Building from a tarball with autotools
For instance:
```sh
$ ./configure --prefix=/usr/local
$ make
$ make install
```
## 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 libsigc++ code itself.
To build from git you may use either the meson build (added in December 2019),
the autotools build (used by most developers in the past) or CMake (should work too).
### Building from git with Meson
You must have meson properly installed (meson, ninja, etc) and you
will also need [mm-common](https://gitlab.gnome.org/GNOME/mm-common/)
version 1.0.0 or higher.
```sh
$ meson --prefix /usr/local --libdir lib yourbuilddir .
$ cd yourbuilddir
$ ninja
$ ninja test
```
### Building from git with autotools
You must have autotools properly installed (autoconf, automake, etc) and you
will also need [mm-common](https://gitlab.gnome.org/GNOME/mm-common/).
```sh
$ ./autogen.sh --prefix=/usr/local
$ make
$ make check
```
### Building from git with CMake
The CMake build is not used very often by the libsigc++ developers, but it
should work, and we would welcome improvements.
For instance:
```sh
$ mkdir libsigcplusplus_build
$ cd libsigcplusplus_build
$ cmake path/to/libsigcplusplus
$ make
```
## Building with Microsoft Visual C++
See MSVC_NMake/README.txt.
|