1 files changed, 35 insertions, 18 deletions

diff --git a/etc/makepkg.conf b/etc/makepkg.conf
index 224a9a9d..792d1dac 100644
--- a/etc/makepkg.conf
+++ b/etc/makepkg.conf
@@ -2,41 +2,58 @@
 # /etc/makepkg.conf
 #
 
-# The FTP/HTTP download utility that makepkg should use to acquire sources
+#########################################################################
+# SOURCE ACQUISITION
+#########################################################################
+#
+#-- The FTP/HTTP download utility that makepkg should use to acquire sources
 export FTPAGENT="/usr/bin/wget --continue --passive-ftp --tries=3 --waitretry=3 --no-check-certificate"
 #export FTPAGENT="/usr/bin/snarf"
 #export FTPAGENT="/usr/bin/lftpget -c"
 
+#########################################################################
+# ARCHITECTURE, COMPILE FLAGS
+#########################################################################
+#
 export CARCH="i686"
 export CHOST="i686-pc-linux-gnu"
-
-# Pentium Pro/Pentium II/Pentium III+/Pentium 4/Athlon exclusive (binaries
-# will use the P6 instruction set and only run on P6+ systems)
+#-- Exclusive: will only run on i686 or higher (P6, Athlon)
 export CFLAGS="-march=i686 -O2 -pipe"
 export CXXFLAGS="-march=i686 -O2 -pipe"
-# Pentium Pro/Pentium II/Pentium III+/Pentium 4/Athlon optimized (but binaries
-# will run on any x86 system)
+#-- Optimized: will run on any x86, but optimized for i686
 #export CFLAGS="-mcpu=i686 -O2 -pipe"
 #export CXXFLAGS="-mcpu=i686 -O2 -pipe"
-
-# SMP Systems
+#-- Make Flags: change this for DistCC/SMP systems
 #export MAKEFLAGS="-j2"
 
-# Enable fakeroot for building packages as a non-root user
+#########################################################################
+# BUILD ENVIRONMENT
+#########################################################################
+#
+#-- Fakeroot: for building packages as a non-root user
 export USE_FAKEROOT="y"
-
-# Enable distributed C/C++/ObjC compiler
-# Also modify MAKEFLAGS to include -jN, where N = 2 * (numCPUs+1)
+#-- DistCC: a distributed C/C++/ObjC compiler (modify MAKEFLAGS too)
 export DISTCC="n"
-# Space-delimited list of hosts running in the distcc cluster
+#-- A space-delimited list of hosts running in the DistCC cluster
 export DISTCC_HOSTS=""
-
-# Enable colorized output messages
+#-- Colorized output messages
 export USE_COLOR="y"
 
-# Specify a fixed directory where all packages will be placed
+#########################################################################
+# GLOBAL PACKAGE OPTIONS
+#########################################################################
+#
+#-- Don't strip symbols from binaries/libraries
+#export NOSTRIP="1"
+#-- Keep doc and info directories
+#export KEEPDOCS="1"
+
+#########################################################################
+# PACKAGE OUTPUT
+#########################################################################
+#
+#-- Destination: specify a fixed directory where all packages will be placed
 #export PKGDEST=/home/packages
-
-# If you want your name to show up in the packages you build, set this.
+#-- Packager: name/email of the person or organization building packages
 #export PACKAGER="John Doe <john@doe.com>"