From 07996bfac7cf172e656f7527794512fd596a9edf Mon Sep 17 00:00:00 2001 From: Allan McRae Date: Wed, 22 Jun 2011 14:07:27 +1000 Subject: 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 (cherry picked from commit 94d22f93096e210cd00d2e9c97c65f77d49ae387) --- doc/pacman.8.txt | 12 ++++++++---- 1 file 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' [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 <> below. When upgrading, pacman performs version comparison -- cgit v1.2.3-24-g4f1b