From 3ddbdc4c1d3130896240452d99dc20f68aeb1ee0 Mon Sep 17 00:00:00 2001 From: Nathan Jones Date: Tue, 8 Jan 2008 15:34:34 -0500 Subject: Documentation updates Document the following: * -R can take a group * -S can take a group and provision I also split up the -S description into multiple paragraphs because it was getting too large. Signed-off-by: Nathan Jones [Dan: added some feedback from the ML, rewrapped lines] Signed-off-by: Dan McGee --- doc/pacman.8.txt | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt index 99133dd9..02e5caf7 100644 --- a/doc/pacman.8.txt +++ b/doc/pacman.8.txt @@ -43,10 +43,12 @@ Operations individual '.tar.gz' packages. See <> below. *-R, \--remove*:: - Remove a package from the system. Files belonging to the specified - package will be deleted, and the database will be updated. Most - configuration files will be saved with a `.pacsave` extension unless the - '\--nosave' option is used. See <> below. + Remove a package from the system. Groups can also be specified to be + removed, in which case every package in that group will be removed. + Files belonging to the specified package will be deleted, and the + database will be updated. Most configuration files will be saved + with a `.pacsave` extension unless the '\--nosave' option is used. + See <> below. *-S, \--sync*:: Synchronize packages. Packages are installed directly from the ftp @@ -54,8 +56,19 @@ Operations example, `pacman -S qt` will download and install qt and all the packages it depends on. If a package name exists in more than one repo, the repo can be explicitly specified to clarify the package to install: - `pacman -S testing/qt`. You can also use `pacman -Su` to upgrade all - packages that are out of date. See <> below. + `pacman -S testing/qt`. ++ +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. ++ +Packages which provide other packages are also handled. For example, `pacman -S +foo` will first look for a foo package. If foo is not found, packages which +provide the same functionality as foo will be searched for. If any package is +found, it will be installed. ++ +You can also use `pacman -Su` to upgrade all packages that are out of date. See +<> below. *-U, \--upgrade*:: Upgrade or add a package to the system. Either a URL or file path can be -- cgit v1.2.3-24-g4f1b