diff --git a/etc/xbps.conf b/etc/xbps.conf
index 0e1bc998..aebae5ea 100644
--- a/etc/xbps.conf
+++ b/etc/xbps.conf
@@ -15,6 +15,14 @@ syslog=true
 
 ## REPOSITORIES
 #
+# The default system repository directory "<prefix>/share/xbps/repo.d"
+# contains the system repository configuration files.
+#
+# Files on that system directory can be overrided in "<sysconfdir>/xbps/repo.d"
+# bearing the same file name, i.e:
+#
+#  - <sysconfdir>/xbps/repo.d/main.conf overrides <prefix>/share/xbps/repo.d/main.conf
+#
 # Local or remote repositories are accepted.
 #
 #  - Local repositories expect an absolute path to the directory that stores
@@ -22,17 +30,24 @@ syslog=true
 #  - Accepted protocols for remote repositories: ftp, http or https.
 #  - Repositories are added in the order in which are specified (top->bottom).
 #
-repository=http://repo.voidlinux.eu/current
-
-# Uncomment this one for "non-free" packages.
-#repository=http://repo.voidlinux.eu/current/nonfree
+# The "repository" keyword can be used to include additional repositories in
+# addition to the files available in <sysconfdir>/xbps/repo.d/*.conf.
+#
+#repository=<url>
 
 # REPOSITORY MIRRORS
-#repository=http://repo2.voidlinux.eu/current
-#repository=http://repo2.voidlinux.eu/current/nonfree
 #
-#repository=http://xbps.nopcode.org/repos/current
-#repository=http://xbps.nopcode.org/repos/current/nonfree
+# - http://repo2.voidlinux.eu/current
+# - http://repo2.voidlinux.eu/current/nonfree
+# - http://repo2.voidlinux.eu/current/multilib
+# - http://repo2.voidlinux.eu/current/multilib/nonfree
+# - http://repo2.voidlinux.eu/current/debug
+#
+# - http://xbps.nopcode.org/repos/current
+# - http://xbps.nopcode.org/repos/current/nonfree
+# - http://xbps.nopcode.org/repos/current/multilib
+# - http://xbps.nopcode.org/repos/current/multilib/nonfree
+# - http://xbps.nopcode.org/repos/current/debug
 
 ## VIRTUAL PACKAGES
 #