diff options
author | Dan McGee <dan@archlinux.org> | 2010-05-05 11:18:27 -0500 |
---|---|---|
committer | Dan McGee <dan@archlinux.org> | 2010-05-05 11:18:27 -0500 |
commit | d485c0370f554758a28eff2cc32b2cc9c72a4604 (patch) | |
tree | 837600604eac5e14a8b1799a4bcce0c7a0517ac5 | |
parent | 9528c36452a6ca8b3718ef5895f31f46c16b17fa (diff) |
Improve documentation of -k/--dbonly
We had the long option wrong in some places and its behavior wasn't
documented at all with regards to -U/--upgrade.
Signed-off-by: Dan McGee <dan@archlinux.org>
-rw-r--r-- | doc/pacman.8.txt | 15 | ||||
-rw-r--r-- | src/pacman/pacman.c | 3 |
2 files changed, 14 insertions, 4 deletions
diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt index 249923a1..3d14a42a 100644 --- a/doc/pacman.8.txt +++ b/doc/pacman.8.txt @@ -90,8 +90,9 @@ to determine which packages need upgrading. This behavior operates as follows: *-U, \--upgrade*:: Upgrade or add package(s) to the system and install the required dependencies from sync repos. Either a URL or file path can be - specified. This is a ``remove-then-add'' process. See <<HCF,Handling Config - Files>> for an explanation on how pacman takes care of config files. + specified. This is a ``remove-then-add'' process. See <<UO,Upgrade + Options>> below; also see <<HCF,Handling Config Files>> for an explanation + on how pacman takes care of config files. *-V, \--version*:: Display version and exit. @@ -273,7 +274,7 @@ Remove Options[[RO]] or more target packages. This operation is recursive, and must be used with care since it can remove many potentially needed packages. -*-k, \--keep*:: +*-k, \--dbonly*:: Removes the database entry only. Leaves all files in place. *-n, \--nosave*:: @@ -375,6 +376,14 @@ linkman:pacman.conf[5]. separating them with a comma. +Upgrade Options[[UO]] +-------------------- +*-k, \--dbonly*:: + Adds the database entries for the specified packages but do not install any + of the files. On an upgrade operation, the existing package and all files + will be removed and the database entry for the new package will be added. + + Handling Config Files[[HCF]] ---------------------------- Pacman uses the same logic as rpm to determine action against files that are diff --git a/src/pacman/pacman.c b/src/pacman/pacman.c index 7461b6ba..09a81059 100644 --- a/src/pacman/pacman.c +++ b/src/pacman/pacman.c @@ -90,7 +90,7 @@ static void usage(int op, const char * const myname) printf("%s:\n", str_opt); printf(_(" -c, --cascade remove packages and all packages that depend on them\n")); printf(_(" -d, --nodeps skip dependency checks\n")); - printf(_(" -k, --dbonly only remove database entry, do not remove files\n")); + printf(_(" -k, --dbonly only remove database entries, do not remove files\n")); printf(_(" -n, --nosave remove configuration files as well\n")); printf(_(" -s, --recursive remove dependencies also (that won't break packages)\n" " (-ss includes explicitly installed dependencies too)\n")); @@ -105,6 +105,7 @@ static void usage(int op, const char * const myname) printf(_(" --asexplicit install packages as explicitly installed\n")); printf(_(" -d, --nodeps skip dependency checks\n")); printf(_(" -f, --force force install, overwrite conflicting files\n")); + printf(_(" -k, --dbonly add database entries, do not install or keep existing files\n")); printf(_(" --print only print the targets instead of performing the operation\n")); printf(_(" --print-format <string>\n" " specify how the targets should be printed\n")); |