GNOME-MODULE(5) | File Formats Manual | GNOME-MODULE(5)

# NAME

`gnome-module` — x11/gnome port module

# DESCRIPTION

This manual page documents the behavior of setting `MODULES=x11/gnome` in the ports(7) tree.

This module has full support for the gnu, simple, meson and cmake CONFIGURE_STYLE.

If `DIST_TUPLE` is set and the gnome template is used, this module will set default values for `GNOME_PROJECT,` `GNOME_VERSION,` `WRKDIST,` and `EXTRACT_SUFX`.

If both `GNOME_PROJECT` and `GNOME_VERSION` are set, this module defines `DISTNAME`, `SITES`, adds x11/gnome to `CATEGORIES` and `EXTRACT_SUFX` will default to .tar.xz if unset.

Unless `NO_BUILD=Yes`, devel/gettext,-tools is appended to `MODGNOME_BUILD_DEPENDS` for ports built using meson(1) and textproc/intltool is appended to `MODULES` for other ports.

`USE_GMAKE` is set to "Yes".

When CONFIGURE_STYLE is set to gnu or simple, if none of `AUTOCONF_VERSION` nor `AUTOMAKE_VERSION` are defined, then "--disable-maintainer-mode" is appended to `CONFIGURE_ARGS`. When CONFIGURE_STYLE is set to cmake, "-DENABLE_MAINTAINER_MODE=OFF" and -DSYSCONF_INSTALL_DIR=${SYSCONFDIR} are appended to CONFIGURE_ARGS.

MODGNOME_CPPFLAGS and MODGNOME_LDFLAGS can be used to add compiler and linker flags. `CPPFLAGS="-I${LOCALBASE}/include"` and `LDFLAGS="-L${LOCALBASE}/lib"` are always appended to `CONFIGURE_ENV` unless MODGNOME_CPPFLAGS or MODGNOME_LDFLAGS is set to "no".

Certain build/run dependencies and configure arguments and environment can be set by appending desktop-file-utils, docbook, gi-docgen, gobject-introspection, gtk-update-icon-cache, shared-mime-info, vala and/or yelp to `MODGNOME_TOOLS`. They are disabled otherwise.

If `MODGNOME_TOOLS` includes desktop-file-utils, a dependency on devel/desktop-file-utils is appended to `MODGNOME_RUN_DEPENDS` and a link to /usr/bin/true is created under ${WRKDIR}/bin/desktop-file-validate.

If `MODGNOME_TOOLS` includes docbook, textproc/docbook-xsl is appended to `MODGNOME_BUILD_DEPENDS`. This option is used when the generation of the man pages included in the source tarball requires docbook XML/SGML/XSL definitions and stylesheets.

If `MODGNOME_TOOLS` includes gi-docgen, textproc/gi-docgen is appended to `MODGNOME_BUILD_DEPENDS`. This option is used to generate documentation using GI-Docgen.

If `MODGNOME_TOOLS` includes gtk-update-icon-cache, a dependency on x11/gtk+4,-guic is appended to `MODGNOME_RUN_DEPENDS`.

If `MODGNOME_TOOLS` includes shared-mime-info, a dependency on misc/shared-mime-info is appended to `MODGNOME_RUN_DEPENDS` and a link to /usr/bin/true is created under ${WRKDIR}/bin/update-mime-database.

If `MODGNOME_TOOLS` includes yelp, textproc/itstool and x11/gnome/doc-utils are appended to `MODGNOME_BUILD_DEPENDS`. Furthermore, x11/gnome/yelp is appended to `MODGNOME_RUN_DEPENDS` if `MODGNOME_TOOLS` also contains "desktop-file-utils" This option is to be used when any files are installed into share/gnome/help/ or page files are installed into share/help/.

`MODGNOME_BUILD_DEPENDS` and `MODGNOME_RUN_DEPENDS` are appended to the corresponding `BUILD_DEPENDS` and `RUN_DEPENDS`.

Some tools require the following tag in the PLIST:

desktop-file-utils

    @tag update-desktop-database

gtk-update-icon-cache ($icon-theme is the theme directory)

    @tag gtk-update-icon-cache %D/share/icons/$icon-theme

shared-mime-info

    @tag update-mime-database

# SEE ALSO

port-modules(5)

August 16, 2025 | Debian