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 <nathanj@insightbb.com>
[Dan: added some feedback from the ML, rewrapped lines]
Signed-off-by: Dan McGee <dan@archlinux.org>
This commit is contained in:
Nathan Jones 2008-01-08 15:34:34 -05:00 committed by Dan McGee
parent 504e6ebb87
commit 3ddbdc4c1d

View file

@ -43,10 +43,12 @@ Operations
individual '.tar.gz' packages. See <<QO,Query Options>> below. individual '.tar.gz' packages. See <<QO,Query Options>> below.
*-R, \--remove*:: *-R, \--remove*::
Remove a package from the system. Files belonging to the specified Remove a package from the system. Groups can also be specified to be
package will be deleted, and the database will be updated. Most removed, in which case every package in that group will be removed.
configuration files will be saved with a `.pacsave` extension unless the Files belonging to the specified package will be deleted, and the
'\--nosave' option is used. See <<RO,Remove Options>> below. database will be updated. Most configuration files will be saved
with a `.pacsave` extension unless the '\--nosave' option is used.
See <<RO,Remove Options>> below.
*-S, \--sync*:: *-S, \--sync*::
Synchronize packages. Packages are installed directly from the ftp 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 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 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: repo can be explicitly specified to clarify the package to install:
`pacman -S testing/qt`. You can also use `pacman -Su` to upgrade all `pacman -S testing/qt`.
packages that are out of date. See <<SO,Sync Options>> below. +
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
<<SO,Sync Options>> below.
*-U, \--upgrade*:: *-U, \--upgrade*::
Upgrade or add a package to the system. Either a URL or file path can be Upgrade or add a package to the system. Either a URL or file path can be