diff options
author | Allan McRae <allan@archlinux.org> | 2011-06-22 14:07:27 +1000 |
---|---|---|
committer | Dan McGee <dan@archlinux.org> | 2011-08-09 18:55:16 -0500 |
commit | 07996bfac7cf172e656f7527794512fd596a9edf (patch) | |
tree | dc01e17b3fd9c380c7607e87dc4e3676296cdb46 | |
parent | 4885a7fa3a54e9a81831916c7925b2996b695f50 (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.txt | 12 |
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 |