WXWIDGETS.ECLASS

Section: eclass-manpages (5)
Updated: Mar 2023
Index Return to Main Contents

NAME

wxwidgets.eclass - Manages build configuration for wxGTK-using packages.

DESCRIPTION

This eclass sets up the proper environment for ebuilds using the wxGTK libraries. Ebuilds using wxPython do not need to inherit this eclass.

More specifically, this eclass controls the configuration chosen by the ${ESYSROOT}/usr/bin/wx-config wrapper.

Using the eclass is simple:

- set WX_GTK_VER equal to a SLOT of wxGTK
- call setup-wxwidgets()

The configuration chosen is based on the version required and the flags wxGTK was built with.

SUPPORTED EAPIS

7 8

FUNCTIONS

setup-wxwidgets

Call this in your ebuild to set up the environment for wxGTK in src_configure. Besides controlling the wx-config wrapper, this exports WX_CONFIG containing the path to the config in case it needs to be passed to the build system.

This function also controls the level of debugging output from the libraries. Debugging features are enabled by default and need to be disabled at the package level. Because this causes many warning dialogs to pop up during runtime, we add -DNDEBUG to CPPFLAGS to disable debugging features (unless your ebuild has a debug USE flag and it's enabled). If you don't like this behavior, you can set WX_DISABLE_NDEBUG to override it.

See: https://docs.wxwidgets.org/trunk/overview_debugging.html

ECLASS VARIABLES

WX_GTK_VER (REQUIRED) (SET BEFORE INHERIT): The SLOT of the x11-libs/wxGTK you're targeting. Needs to be defined before inheriting the eclass. Can be either "3.0" or "3.0-gtk3".

MAINTAINERS

wxwidgets@gentoo.org

REPORTING BUGS

Please report bugs via https://bugs.gentoo.org/

FILES

wxwidgets.eclass

This document was created by man2html, using the manual pages.
Time: 03:27:01 GMT, March 21, 2023