Update PKGBUILD configuration section

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.

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`
+- `_reuse_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_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: