summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAllan McRae <allan@archlinux.org>2011-06-22 14:07:27 +1000
committerDan McGee <dan@archlinux.org>2011-08-09 18:55:16 -0500
commit07996bfac7cf172e656f7527794512fd596a9edf (patch)
treedc01e17b3fd9c380c7607e87dc4e3676296cdb46
parent4885a7fa3a54e9a81831916c7925b2996b695f50 (diff)
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> (cherry picked from commit 94d22f93096e210cd00d2e9c97c65f77d49ae387)
-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 a4d41d0e..9dd748a3 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