BRANDING.ECLASS

Section: eclass-manpages (5)
Updated: Jan 2026
Index Return to Main Contents

NAME

branding.eclass - Branding variables with Gentoo defaults

DESCRIPTION

This defines a set of variables for applying branding to various packages. The variables default to Gentoo values. These can be overridden by downstream distributions.

SUPPORTED EAPIS

8 9

ECLASS VARIABLES

BRANDING_OS_NAME ?= Gentoo (GENERATED BY ECLASS): Corresponds to os-release's NAME. See os-release(5).
BRANDING_OS_ID ?= gentoo (GENERATED BY ECLASS): Corresponds to os-release's ID. See os-release(5). This variable has strict formatting requirements.
BRANDING_OS_ID_LIKE (GENERATED BY ECLASS): Corresponds to os-release's ID_LIKE. See os-release(5).
BRANDING_OS_HOME_URL ?= https://www.gentoo.org/ (GENERATED BY ECLASS): Corresponds to os-release's HOME_URL. See os-release(5).
BRANDING_OS_SUPPORT_URL ?= https://www.gentoo.org/support/ (GENERATED BY ECLASS): Corresponds to os-release's SUPPORT_URL. See os-release(5).
BRANDING_OS_BUG_REPORT_URL ?= https://bugs.gentoo.org/ (GENERATED BY ECLASS): Corresponds to os-release's BUG_REPORT_URL. See os-release(5).
BRANDING_OS_VERSION (GENERATED BY ECLASS): Corresponds to os-release's VERSION. See os-release(5). This is typically set by sys-apps/baselayout to PV when creating /etc/os-release. As such, it is not readable by other packages unless overridden globally, but baselayout's PV has little relevance to other packages anyway.
BRANDING_OS_VERSION_ID (GENERATED BY ECLASS): Corresponds to os-release's VERSION_ID. See os-release(5). This variable has strict formatting requirements. Like BRANDING_OS_VERSION above, this is also set by baselayout to PV.
BRANDING_OS_PRETTY_NAME ?= "Gentoo Linux" (GENERATED BY ECLASS): Corresponds to os-release's PRETTY_NAME. See os-release(5). If completely unset, defaults to "Gentoo Linux". If set but blank, defaults to the concatenation of BRANDING_OS_NAME and BRANDING_OS_VERSION.

AUTHORS

James Le Cuirot <chewi@gentoo.org>

MAINTAINERS

James Le Cuirot <chewi@gentoo.org>

REPORTING BUGS

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

FILES

branding.eclass

This document was created by man2html, using the manual pages.
Time: 03:27:00 GMT, January 21, 2026