From 3bd87a8adfebcc22f55823568418f7cb4365a245 Mon Sep 17 00:00:00 2001 From: Mike Gilbert Date: Tue, 14 Sep 2021 10:00:46 -0400 Subject: sys-boot/grub: document global variables Bug: https://bugs.gentoo.org/813037 Signed-off-by: Mike Gilbert --- sys-boot/grub/grub-2.06-r1.ebuild | 13 +++++++++++++ sys-boot/grub/grub-9999.ebuild | 13 +++++++++++++ 2 files changed, 26 insertions(+) (limited to 'sys-boot') diff --git a/sys-boot/grub/grub-2.06-r1.ebuild b/sys-boot/grub/grub-2.06-r1.ebuild index 09e5054052a6..932676d67fd8 100644 --- a/sys-boot/grub/grub-2.06-r1.ebuild +++ b/sys-boot/grub/grub-2.06-r1.ebuild @@ -3,6 +3,19 @@ EAPI=7 +# This ebuild uses 3 special global variables: +# GRUB_BOOTSTRAP: Depend on python and invoke bootstrap (gnulib). +# GRUB_AUTOGEN: Depend on python and invoke the autogen.sh. +# GRUB_AUTORECONF: Inherit autotools and invoke eautoreconf. +# +# When applying patches: +# If gnulib is updated, set GRUB_BOOTSTRAP=1 +# If *.def is updated, set GRUB_AUTOGEN=1 +# If gnulib, *.def, or any autotools files are updated, set GRUB_AUTORECONF=1 +# +# If any of the above applies to a user patch, the user should set the +# corresponding variable in make.conf or the environment. + if [[ ${PV} == 9999 ]]; then GRUB_AUTORECONF=1 GRUB_BOOTSTRAP=1 diff --git a/sys-boot/grub/grub-9999.ebuild b/sys-boot/grub/grub-9999.ebuild index 119378453e6b..7ba93a504196 100644 --- a/sys-boot/grub/grub-9999.ebuild +++ b/sys-boot/grub/grub-9999.ebuild @@ -3,6 +3,19 @@ EAPI=7 +# This ebuild uses 3 special global variables: +# GRUB_BOOTSTRAP: Depend on python and invoke bootstrap (gnulib). +# GRUB_AUTOGEN: Depend on python and invoke the autogen.sh. +# GRUB_AUTORECONF: Inherit autotools and invoke eautoreconf. +# +# When applying patches: +# If gnulib is updated, set GRUB_BOOTSTRAP=1 +# If *.def is updated, set GRUB_AUTOGEN=1 +# If gnulib, *.def, or any autotools files are updated, set GRUB_AUTORECONF=1 +# +# If any of the above applies to a user patch, the user should set the +# corresponding variable in make.conf or the environment. + if [[ ${PV} == 9999 ]]; then GRUB_AUTORECONF=1 GRUB_BOOTSTRAP=1 -- cgit v1.2.3-65-gdbad