summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan McGee <dan@archlinux.org>2008-01-10 00:12:51 -0600
committerDan McGee <dan@archlinux.org>2008-01-10 22:58:48 -0600
commit887ad59eb68fbbda4ad50a7f073448fd7fe28f99 (patch)
tree4e33695e46df5f4f03513a59e15b14f5aeafac29
parent71ca587f2a47a9ed8f9497d4685989e00f968202 (diff)
downloadpacman-887ad59eb68fbbda4ad50a7f073448fd7fe28f99.tar.xz
doc: add note to pacman.conf manpage explaining $repo
Fixes FS#9142. Signed-off-by: Dan McGee <dan@archlinux.org>
-rw-r--r--doc/pacman.conf.5.txt31
1 files changed, 26 insertions, 5 deletions
diff --git a/doc/pacman.conf.5.txt b/doc/pacman.conf.5.txt
index f18244d1..95298633 100644
--- a/doc/pacman.conf.5.txt
+++ b/doc/pacman.conf.5.txt
@@ -33,8 +33,8 @@ Example
NoUpgrade = etc/passwd etc/group etc/shadow
NoUpgrade = etc/fstab
-[current]
-Include = /etc/pacman.d/current
+[core]
+Include = /etc/pacman.d/core
[custom]
Server = file:///home/pkgs
@@ -137,9 +137,30 @@ defined with the 'Server' directive and follow a URL naming structure. If you
want to use a local directory, you can specify the full path with a ``file://''
prefix, as shown above.
-The order of repositories in the file matters; repositories listed first will
-take precedence over those listed later in the file when packages in two
-repositories have identical names, regardless of version number.
+A common way to define DB locations utilizes the 'Include' directive. For each
+repository defined in the configuration file, a single 'Include' directive can
+contain a file that lists the servers for that repository.
+
+--------
+[core]
+# use this repository first
+Server = ftp://ftp.archlinux.org/core/os/arch
+# next use servers as defined in the mirrorlist below
+Include = /etc/pacman.d/mirrorlist
+--------
+
+During parsing, pacman will define the `$repo` variable to the name of the
+current section. This is often utilized in files specified using the 'Include'
+directive so all repositories can use the same mirrorfile.
+
+--------
+Server = ftp://ftp.archlinux.org/$repo/os/arch
+--------
+
+The order of repositories in the configuration files matters; repositories
+listed first will take precedence over those listed later in the file when
+packages in two repositories have identical names, regardless of version
+number.
Using Your Own Repository
-------------------------