From eb751fe8e941ddec68258dbe9d232a923f0ad2e2 Mon Sep 17 00:00:00 2001
From: Orfeas <38209077+0xfea5@users.noreply.github.com>
Date: Mon, 16 Feb 2026 15:33:27 +0200
Subject: make.defaults: simplify comments

---
 profiles/amd64-desktop/make.defaults | 118 ++++++++++++++++++-----------------
 1 file changed, 61 insertions(+), 57 deletions(-)

diff --git a/profiles/amd64-desktop/make.defaults b/profiles/amd64-desktop/make.defaults
index ac851eb..b97bb64 100644
--- a/profiles/amd64-desktop/make.defaults
+++ b/profiles/amd64-desktop/make.defaults
@@ -1,16 +1,20 @@
-# CPU flags
-#
+#-----#
+# CPU #
+#-----#
 CPU_FLAGS_X86="mmx mmxext sse sse2 sse3 ssse3 sse4_1 sse4_2 popcnt"
 
-# LTO flags
-#
-# SOURCE: https://wiki.gentoo.org/wiki/LTO#Enabling_LTO_System-wide
+#-------------------------------------------------------------------#
+# LTO                                                               #
+#                                                                   #
+# Source: https://wiki.gentoo.org/wiki/LTO#Enabling_LTO_System-wide #
+#-------------------------------------------------------------------#
 WARNING_FLAGS="-Werror=odr -Werror=lto-type-mismatch -Werror=strict-aliasing"
 LTO_FLAGS="-flto ${WARNING_FLAGS}"
 USE="${USE} lto"
 
-# Common compilation flags
-#
+#-------------------#
+# Compilation flags #
+#-------------------#
 COMMON_FLAGS="-march=x86-64-v3 -O2 -pipe ${LTO_FLAGS}"
 RUSTFLAGS="-C target-cpu=x86-64"
 
@@ -19,82 +23,82 @@ CXXFLAGS="${COMMON_FLAGS}"
 FCFLAGS="${COMMON_FLAGS}"
 FFLAGS="${COMMON_FLAGS}"
 
-# Distro
-#
-# Enable: distribution kernel, prebuilt binaries
+#--------#
+# Gentoo #
+#--------#
 USE="${USE} dist-kernel bindist"
 
-# Security
-#
-# Enable: process capabilities, file capabilities, access control lists
-# Disable: suid, single-use key
+#----------#
+# Security #
+#----------#
 USE="${USE} caps filecaps acl -suid -skey"
 
-# Optimizations
-#
-# Enable: orc
-#
-# NOTES: hardened profile disables orc which is mostly safe and provides
-# speedup
+#---------------#
+# Optimizations #
+#---------------#
 USE="${USE} orc"
 
-# Desktop
-#
-# Enable: screencast support, fontconfig
+#---------#
+# Desktop #
+#---------#
 USE="${USE} screencast fontconfig"
 
-# Xorg
-#
-# Disable: X and its extensions
-#
-# NOTES: enable them per-package
+#------#
+# Xorg #
+#------#
 USE="${USE} -X -xcomposite -xpresent -xinerama -xscreensaver -xv -startup-notification"
 
-# GTK & QT
-#
-# Enable: introspection and gstreamer for GTK, qml for QT
-# Disable: gtk documentation and gtk2, gtk3, qt5, qt6 toolkits
-#
-# NOTES: enable them per-package
+#-----#
+# GTK #
+#-----#
 USE="${USE} introspection gstreamer -gtk2 -gtk3 -gtk-doc"
+
+#----#
+# QT #
+#----#
 USE="${USE} qml -qt5 -qt6"
 
-# GNOME & KDE
-#
-# Disable: disable gnome and kde services/features which are not strictly necessary to run a standalone desktop
+#-------#
+# GNOME #
+#-------#
 USE="${USE} -gnome -eds -gnome-online-accounts -sysprof"
+
+#-----#
+# KDE #
+#-----#
 USE="${USE} -kde -plasma -kwallet -kaccounts"
 
-# Audio
-#
-# Enable: jack, pipewire
+#-------#
+# Audio #
+#-------#
 USE="${USE} jack pipewire"
 
-# Graphics
-#
-# Enable: vaapi, vulkan
+#----------#
+# Graphics #
+#----------#
 USE="${USE} vaapi vulkan"
 
-# Misc
-#
-# Enable: fftw library, MTP for android file transfer
+#------#
+# Misc #
+#------#
 USE="${USE} fftw mtp"
 
-# Video cards
-#
-# Enable: framebuffer device (basic), AMD related video card support
+#-------------#
+# Video cards #
+#-------------#
 VIDEO_CARDS="fbdev amdgpu radeon radeonsi zink"
 
-# Input devices
-#
-# Enable: evdev, libinput (manages most common inputs such as mouse, keyboard, touchpad etc)
+#---------------#
+# Input Devices #
+#---------------#
 INPUT_DEVICES="evdev libinput"
 
-# Localization
-#
+#--------------#
+# Localization #
+#--------------#
 L10N=""
 
-# Licensing
-#
-# Enable: nothing except free and binary redistributables
+#----------#
+# Licenses #
+#----------#
 ACCEPT_LICENSE="-* @FREE @BINARY-REDISTRIBUTABLE"
-- 
cgit v1.2.3