Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/doc/pacman.8.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pacman.8.in')
-rw-r--r--doc/pacman.8.in49
1 files changed, 28 insertions, 21 deletions
diff --git a/doc/pacman.8.in b/doc/pacman.8.in
index 46c53bf9..3ca7fa0f 100644
--- a/doc/pacman.8.in
+++ b/doc/pacman.8.in
@@ -1,4 +1,4 @@
-.TH pacman 8 "September 17, 2004" "pacman @PACKAGE_VERSION@" ""
+.TH pacman 8 "January 21, 2006" "pacman #VERSION#" ""
.SH NAME
pacman \- package manager utility
.SH SYNOPSIS
@@ -81,8 +81,12 @@ Output more status and error messages.
Specify an alternate configuration file.
.TP
.B "\-\-noconfirm"
-Bypass any and all "Are you sure?" messages. It's not a good to do this
+Bypass any and all "Are you sure?" messages. It's not a good idea to do this
unless you want to run pacman from a script.
+.TP
+.B "\-\-noprogressbar"
+Do not show a progress bar when downloading files. This can be useful for
+scripts that call pacman and capture the output.
.SH SYNC OPTIONS
.TP
.B "\-c, \-\-clean"
@@ -105,18 +109,14 @@ dependencies, conflicts, etc.
List all files in the specified repositories. Multiple repositories can
be specified on the command line.
.TP
-.B "\-m, \-\-foreign"
-List all packages that were not found in the sync database(s). Typically these
-are packages that were downloaded manually and installed with --add.
-.TP
.B "\-p, \-\-print-uris"
-Print out URIs for each specified package and its dependencies. These
-can be piped to a file and downloaded at a later time, using a program
-like wget.
+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 downloaded at a later time, using a program like wget.
.TP
-.B "\-s, \-\-search <string>"
+.B "\-s, \-\-search <regexp>"
This will search each package in the package list for names or descriptions
-that contains <string>.
+that matches <regexp>.
.TP
.B "\-u, \-\-sysupgrade"
Upgrades all packages that are out of date. pacman will examine every
@@ -158,7 +158,7 @@ removed.
For each target specified, remove it and all its dependencies, provided
that (A) they are not required by other packages; and (B) they were not
explicitly installed by the user.
-This option is analogous to a backwards --sync operation.
+This option is analagous to a backwards --sync operation.
.SH QUERY OPTIONS
.TP
.B "\-e, \-\-orphans"
@@ -178,6 +178,10 @@ option then the .PKGINFO file will be printed.
List all files owned by <package>. Multiple packages can be specified on
the command line.
.TP
+.B "\-m, \-\-foreign"
+List all packages that were not found in the sync database(s). Typically these
+are packages that were downloaded manually and installed with --add.
+.TP
.B "\-o, \-\-owns <file>"
Search for the package that owns <file>.
.TP
@@ -186,9 +190,9 @@ Tells pacman that the package supplied on the command line is a
file, not an entry in the database. Pacman will decompress the
file and query it. This is useful with \fB--info\fP and \fB--list\fP.
.TP
-.B "\-s, \-\-search <string>"
+.B "\-s, \-\-search <regexp>"
This will search each locally-installed package for names or descriptions
-that contains <string>.
+that matches <regexp>.
.SH HANDLING CONFIG FILES
pacman uses the same logic as rpm to determine action against files
that are designated to be backed up. During an upgrade, it uses 3
@@ -214,9 +218,9 @@ original=\fBX\fP, current=\fBY\fP, new=\fBY\fP
The new one is identical to the current one. Win win. Install the new file.
.TP
original=\fBX\fP, current=\fBY\fP, new=\fBZ\fP
-All three files are different. So we install the new file, but back up the
-old one to a .pacsave extension. This way the user can move the old configuration
-file back into place if he wishes.
+All three files are different, so we install the new file with a .pacnew
+extension and warn the user, so she can manually move the file into place
+after making any necessary customizations.
.SH CONFIGURATION
pacman will attempt to read \fI/etc/pacman.conf\fP each time it is invoked. This
configuration file is divided into sections or \fIrepositories\fP. Each section
@@ -244,10 +248,6 @@ Server = file:///home/pkgs
Overrides the default location of the toplevel database directory. The default is
\fIvar/lib/pacman\fP.
.TP
-.B "CacheDir = path/to/cache/dir"
-Overrides the default location of the package cache directory. The default is
-\fIvar/cache/pacman\fP.
-.TP
.B "HoldPkg = <package> [package] ..."
If a user tries to \fB--remove\fP a package that's listed in HoldPkg, pacman
will ask for confirmation before proceeding.
@@ -280,6 +280,13 @@ Disables passive ftp connections when downloading packages. (aka Active Mode)
All files listed with a \fBNoUpgrade\fP directive will never be touched during a package
install/upgrade. \fINote:\fP do not include the leading slash when specifying files.
.TP
+.B "NoExtract = <file> [file] ..."
+All files listed with a \fBNoExtract\fP directive will never be extracted from
+a package into the filesystem. This can be useful when you don't want part of
+a package to be installed. For example, if your httpd root uses an index.php,
+then you would not want the index.html file to be extracted from the apache
+package.
+.TP
.B "UseSyslog"
Log action messages through syslog(). This will insert pacman log entries into your
/var/log/messages or equivalent.