A few more slight changes to the pacman man page

This commit is contained in:
Dan McGee 2007-02-11 00:27:45 +00:00
parent 97efe292ff
commit 0597640129
1 changed files with 23 additions and 20 deletions

View File

@ -13,18 +13,22 @@ pacman \- package manager utility
.SH DESCRIPTION .SH DESCRIPTION
\fBpacman\fP is a \fIpackage management\fP utility that tracks installed \fBpacman\fP is a \fIpackage management\fP utility that tracks installed
packages on a Linux system. It has dependency support, package groups, install packages on a Linux system. It features dependency support, package groups,
and uninstall hooks, and the ability to sync your local machine with a remote install and uninstall hooks, and the ability to sync your local machine with a
ftp server to automatically upgrade packages. \fBpacman\fP packages are a remote ftp server to automatically upgrade packages. \fBpacman\fP packages are
zipped tar format. a zipped tar format.
Since version 3.0.0, \fBpacman\fP has been the frontend to \fBlibalpm\fP, the
"Arch Linux Package Management" library. This library allows alternative front
ends to be written (for instance, a GUI front end).
.SH OPERATIONS .SH OPERATIONS
.TP .TP
.B \-A, --add (deprecated) .B \-A, --add (deprecated)
Add a package to the system. Package will be uncompressed into the installation Add a package to the system. The package will be uncompressed into the
root and the database will be updated. The package will not be installed if installation root and the database will be updated. The package will not be
another version is already installed. Please use \fB--upgrade\fP in place of installed if another version is already installed. Please use \fB--upgrade\fP
this option. in place of this option.
.TP .TP
.B \-F, --freshen .B \-F, --freshen
This is like \fB--upgrade\fP except it will only upgrade packages already This is like \fB--upgrade\fP except it will only upgrade packages already
@ -32,7 +36,7 @@ installed on the system.
.TP .TP
.B \-Q, --query .B \-Q, --query
Query the package database. This operation allows you to view installed Query the package database. This operation allows you to view installed
packages and their files, as well as meta-info about individual packages packages and their files, as well as meta-information about individual packages
(dependencies, conflicts, install date, build date, size). This can be run (dependencies, conflicts, install date, build date, size). This can be run
against the local package database or can be used on individual .tar.gz against the local package database or can be used on individual .tar.gz
packages. See \fBQUERY OPTIONS\fP below. packages. See \fBQUERY OPTIONS\fP below.
@ -45,7 +49,7 @@ is used. See \fBREMOVE OPTIONS\fP below.
.TP .TP
.B \-S, --sync .B \-S, --sync
Synchronize packages. Packages are installed directly from the ftp servers, Synchronize packages. Packages are installed directly from the ftp servers,
complete with all dependencies required to run the packages. For example, including all dependencies required to run the packages. For example,
\fBpacman -S qt\fP will download and install \fBqt\fP and all the packages it \fBpacman -S qt\fP will download and install \fBqt\fP and all the packages it
depends on. You can also use \fBpacman -Su\fP to upgrade all packages that are depends on. You can also use \fBpacman -Su\fP to upgrade all packages that are
out of date. See \fBSYNC OPTIONS\fP below. out of date. See \fBSYNC OPTIONS\fP below.
@ -76,7 +80,7 @@ option will cause all those files to be overwritten. This option should be
used with care, ideally not at all. used with care, ideally not at all.
.TP .TP
.B \-r, --root \fIpath\fP .B \-r, --root \fIpath\fP
Specify alternative installation root (default is "/"). However, this should Specify an alternative installation root (default is "/"). However, this should
\fInot\fP be used as a way to install software into /usr/local instead of /usr, \fInot\fP be used as a way to install software into /usr/local instead of /usr,
for example. This option should be used if you want to install a package on a for example. This option should be used if you want to install a package on a
temporary mounted partition, which is "owned" by another system. By using this temporary mounted partition, which is "owned" by another system. By using this
@ -104,8 +108,8 @@ List all packages that were pulled in by a previously installed package but no
longer required by any installed package. longer required by any installed package.
.TP .TP
.B \-g, --groups .B \-g, --groups
Display all package members of a named group, or all grouped packages if Display all packages that are members of a named group. If not name is
no name is specified. specified, list all grouped packages.
.TP .TP
.B \-i, --info .B \-i, --info
Display information on a given package. The \fB-p\fP option can be used if Display information on a given package. The \fB-p\fP option can be used if
@ -125,7 +129,7 @@ Search for the package that owns \fIfile\fP.
.B \-p, --file .B \-p, --file
Signifies that the package supplied on the command line is a file and not an Signifies that the package supplied on the command line is a file and not an
entry in the database. The file will be decompressed and queried. This is entry in the database. The file will be decompressed and queried. This is
useful with \fB--info\fP and \fB--list\fP. useful in combination with \fB--info\fP and \fB--list\fP.
.TP .TP
.B \-s, --search \fIregexp\fP .B \-s, --search \fIregexp\fP
This will search each locally-installed package for names or descriptions that This will search each locally-installed package for names or descriptions that
@ -150,10 +154,9 @@ removed from the system the database is checked to see if the file should be
renamed with a .pacsave extension. renamed with a .pacsave extension.
.TP .TP
.B \-s, --recursive .B \-s, --recursive
For each target specified, remove it and all its dependencies, provided that Remove each target specified including all dependencies, provided that (A) they
(A) they are not required by other packages; and (B) they were not explicitly are not required by other packages; and (B) they were not explicitly installed
installed by the user. This option is analogous to a backwards \fB--sync\fP by the user. This option is analogous to a backwards \fB--sync\fP operation.
operation.
.SH SYNC OPTIONS .SH SYNC OPTIONS
.TP .TP
@ -177,8 +180,8 @@ specified on the command line.
.TP .TP
.B \-p, --print-uris .B \-p, --print-uris
Print out URIs for each package that will be installed, including any Print out URIs for each package that will be installed, including any
dependencies that have yet to be installed. These can be piped to a file and dependencies yet to be installed. These can be piped to a file and downloaded
downloaded at a later time, using a program like wget. at a later time, using a program like wget.
.TP .TP
.B \-s, --search \fIregexp\fP .B \-s, --search \fIregexp\fP
This will search each package in the sync databases for names or descriptions This will search each package in the sync databases for names or descriptions