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)