summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAllan McRae <allan@archlinux.org>2011-06-22 06:07:27 +0200
committerDan McGee <dan@archlinux.org>2011-06-24 09:02:40 +0200
commit94d22f93096e210cd00d2e9c97c65f77d49ae387 (patch)
tree49243d2e1d8518569939bedc24eb8cff4e32a373
parent4bdb868ac8d535a3818d519b16eff7d129fe6717 (diff)
downloadpacman-94d22f93096e210cd00d2e9c97c65f77d49ae387.tar.gz
pacman-94d22f93096e210cd00d2e9c97c65f77d49ae387.tar.xz
Document group and providers selection
The format required for selection of packages within the group selection dialog is not entirely obvious, so provide some documentation. Fixes FS#24134. Signed-off-by: Allan McRae <allan@archlinux.org>
-rw-r--r--doc/pacman.8.txt12
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 531c992a..64b1ff3a 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -13,7 +13,6 @@ Synopsis
--------
'pacman' <operation> [options] [targets]
-
Description
-----------
Pacman is a package management utility that tracks installed packages on a Linux
@@ -69,13 +68,18 @@ Operations
interprets ">" as redirection to file.)
+
In addition to packages, groups can be specified as well. For example, if
-gnome is a defined package group, then `pacman -S gnome` will install every
-package in the gnome group, as well as the dependencies of those packages.
+gnome is a defined package group, then `pacman -S gnome` will provide a
+prompt allowing you to select which packages to install from a numbered list.
+The package selection is specified using a space separated list of package
+numbers. Sequential packages may be selected by specifying the first and last
+package numbers separated by a hyphen (`-`). Excluding packages is achieved by
+prefixing a number or range of numbers with a caret (`^`).
+
Packages that provide other packages are also handled. For example, `pacman -S
foo` will first look for a foo package. If foo is not found, packages that
provide the same functionality as foo will be searched for. If any package is
-found, it will be installed.
+found, it will be installed. A selection prompt is provided if multiple packages
+providing foo are found.
+
You can also use `pacman -Su` to upgrade all packages that are out of date. See
<<SO,Sync Options>> below. When upgrading, pacman performs version comparison