From b4c62af68948f36e5b7e13bb63635257cf2159e8 Mon Sep 17 00:00:00 2001
From: Nils Freydank <nils.freydank@posteo.de>
Date: Sun, 22 Oct 2023 13:14:53 +0200
Subject: [PATCH] Elaborate make.conf

---
 make.conf/portage | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/make.conf/portage b/make.conf/portage
index 28aff24..99616c5 100644
--- a/make.conf/portage
+++ b/make.conf/portage
@@ -1,26 +1,33 @@
+# === General options
 ACCEPT_KEYWORDS="~amd64"
 EMERGE_DEFAULT_OPTS="--quiet-build --autounmask=n --binpkg-respect-use=y"
 FEATURES="buildpkg clean-logs compress-build-logs noinfo preserve-libs"
 FEATURES="${FEATURES} -ipc-sandbox -network-sandbox -pid-sandbox"
 MAKEOPTS="-j7 -l8"
-#
+
+# === Binary package configurations
+# Signing configuration.
+#BINPKG_GPG_SIGNING_KEY="0x1234567890ABCDEF"
+#BINPKG_GPG_SIGNING_GPG_HOME="/var/lib/portage/home/.gnupg"
+#FEATURES="${FEATURES} binpkg-signing"
+# Format and compression.
 BINPKG_FORMAT="gpkg"
 PORTAGE_COMPRESS="xz"
 PORTAGE_COMPRESS_FLAGS="-9 -T6 --memlimit-decompress=1500M"
 BINPKG_COMPRESS="${PORTAGE_COMPRESS}"
 BINPKG_COMPRESS_FLAGS="${PORTAGE_COMPRESS_FLAGS}"
-#BINPKG_GPG_SIGNING_GPG_HOME="/var/lib/portage/home/.gnupg"
-#BINPKG_GPG_SIGNING_KEY="0x1234567890ABCDEF"
-#FEATURES="${FEATURES} binpkg-signing"
 
+# === Paths where portage stores source files and binpkgs.
 # see bug #662982
 P_BASE="/var/cache"
 DISTDIR="${P_BASE}/distfiles"
 PKGDIR="${P_BASE}/packages"
 
+# === Paths for logging and retention policy.
 PORT_LOGDIR="/var/log/portage"
 PORT_LOGDIR_CLEAN="find \"${PORT_LOGDIR}\" -type f ! -name \"summary.log*\" -mtime +84 -delete"
 
+# === Output language for logs.
 # This sets the language of build output to English.
 # Please keep this setting intact when reporting bugs.
 LC_MESSAGES=C