libsigc++ for Mac

libsigc++ Typesafe Callback Framework for C++

Introduction

libsigc++ (a.k.a. libsigcplusplus) 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.

sigc++-2.0 and sigc++-3.0 are different parallel-installable ABIs. This file describes sigc++-3.0.

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().

General information

Web site https://libsigcplusplus.github.io/libsigcplusplus/

Download location https://download.gnome.org/sources/libsigc++/ (until 3.6.0) https://github.com/libsigcplusplus/libsigcplusplus/releases/

Reference documentation https://libsigcplusplus.github.io/libsigcplusplus/reference/html/

Tarballs contain reference documentation. In tarballs generated with Meson, see the untracked/docs/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://github.com/libsigcplusplus/libsigcplusplus

Bugs can be reported to https://github.com/libsigcplusplus/libsigcplusplus/issues

Patches can be submitted to https://github.com/libsigcplusplus/libsigcplusplus/pulls

Building

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 the documentation

The reference documentaion is built with Doxygen.

The manual is a DocBook 5.0 document. These packages are recommended when building the manual (can have other names in other distros): docbook5-xml (Ubuntu and Debian) or docbook5-schemas (Fedora) docbook-xsl (Ubuntu and Debian) or docbook-style-xsl (Fedora)

It may be possible to build without these packages, but it will be slow and error prone. The xmllint command is told to read files from http://docbook.org. The xsltproc command is told to read files from http://docbook.sourceforge.net. The commands first search for local copies of those files. If local copies exist and are installed at expected locations, the commands make no network accesses.

Building from a release tarball

Building from a release tarball is easier than building from git.

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.