From ff0209bf6e3d9e5b343ac617603dc5c6d8b15353 Mon Sep 17 00:00:00 2001 From: JeremyStarTM Date: Sun, 22 Dec 2024 19:18:23 +0100 Subject: [PATCH] Update PKGBUILD configuration section --- PKGBUILD | 20 ++++++++++++++++++-- README.md | 13 ++++++++----- 2 files changed, 26 insertions(+), 7 deletions(-) diff --git a/PKGBUILD b/PKGBUILD index f56610e..8c1a5d3 100644 --- a/PKGBUILD +++ b/PKGBUILD @@ -43,6 +43,14 @@ # NOT recommended when a new kernel is # released, but again, convenient for # package bumps. +# +# Takes effect before '_reuse_file'. +# +# Only takes effect if '_reuse_current' +# or '_reuse_file' is enabled. Keep +# disabled if you want to reuse your +# existing kernel configuration without +# any changes being applied on top. # # Set to anything but null to activate. : "${_reuse_current:=""}" @@ -61,6 +69,14 @@ # released, but again, convenient for # package bumps. # +# Takes effect after '_reuse_current'. +# +# Only takes effect if '_reuse_current' +# or '_reuse_file' is enabled. Keep +# disabled if you want to reuse your +# existing kernel configuration without +# any changes being applied on top. +# # Set to anything but null to activate. : "${_reuse_file:=""}" @@ -170,7 +186,7 @@ # Set to '1' by default : "${_subarch_microarch:="1"}" -# Enable compilation with LLVM +# Enables compilation with LLVM # # Be warned, this is largely untested # by me (JeremyStarTM). It *should* work, @@ -200,7 +216,7 @@ # ignore debug options. : "${_debug_kernel:=""}" -# This allows you to enable or disable +# This allows you to enable # debug options for THIS SCRIPT. # # Set to anything but null to activate. diff --git a/README.md b/README.md index 92094af..0bad1f3 100644 --- a/README.md +++ b/README.md @@ -14,16 +14,19 @@ The PKGBUILD file supports customization via environment variables. Here's a lis - `_makemenuconfig`: Invokes `make menuconfig` (ncurses-based default configuration menu) before compilation starts - `_makenconfig`: Invokes `make nconfig` (ncurses-based nicer configuration menu) before compilation starts - `_makexconfig`: Invokes `make xconfig` (X11-based GUI configuration menu) before compilation starts -- `_use_current`: Will use the configuration of the running kernel, if the running kernel is compiled with `IKCONFIG_PROC` -- `_optimize_defconfig`: Applies package maintainer-picked configuration changes to your defconfig. Only takes effect with `_use_current` being enabled +- `_reuse_current`: Will use the configuration of the running kernel, if the running kernel is compiled with `IKCONFIG_PROC` +- `_reuse_file`: Will use the configuration file named `kconfig` contained in the `PKGBUILD` file's directory +- `_update_kconfig_on_reuse`: Specifies whether the kernel configuration shall be updated when using any of the '_reuse_*' flags - `_copyfinalconfig`: Copies the final kernel configuration into the repository root as `kconfig-new` before compilation starts - `_localmodcfg`: Only compiles modules found in modprobed-db's database (which decreases compilation time and kernel size) - `_use_llvm_lto`: Compiles the kernel with LLVM instead of GCC. Should work, if not open an issue -- `_subarch`: Specifies the subarchitecture to compile for (see the [PKGBUILD file](https://git.staropensource.de/JeremyStarTM/aur-linux-clear/src/branch/develop/PKGBUILD) for a list of all subarches). Default is `41` (Generic x86-64), which is compatible with all amd64 processors. Must be a number +- `_subarch`: Specifies the subarchitecture to compile for (see the [`PKGBUILD` file](https://git.staropensource.de/JeremyStarTM/aur-linux-clear/src/branch/develop/PKGBUILD) for a list of all subarches). Default is `41` (Generic x86-64), which is compatible with all amd64 processors. Must be a number +- `_use_llvm_lto`: Enables compilation with LLVM. Untested but should work. If not write a comment on the AUR. - `_subarch_microarch`: Specifies the microarchitecture to compile for. Only applies to and is required by the `GENERIC_CPU` subarch. Must be a number between `1` and `4` ([click for more information](https://en.wikipedia.org/wiki/X86-64#Microarchitecture_levels)) -- `_debug`: Force enables debug options when set to `y`, force disables debug options when set to `n` or uses the config defaults when unset +- `_debug_kernel`: Force enables kernel debugging options when set to `y`, force disables debug options when set to `n` or relies on the kconfig when unset +- `_debug_script`: Enables debugging for the `PKGBUILD` file -All of these variables just need to be set for them to apply, except for `_subarch` and `_debug`. See their descriptions for more information. +All of these variables just need to be set for them to apply, except for `_subarch` and `_debug`. **For more information please check their documentation inside the `PKGBUILD` file** ## GPG errors If makepkg complains about invalid PGP keys, try running this command: