From d485c0370f554758a28eff2cc32b2cc9c72a4604 Mon Sep 17 00:00:00 2001 From: Dan McGee Date: Wed, 5 May 2010 11:18:27 -0500 Subject: 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 --- doc/pacman.8.txt | 15 ++++++++++++--- 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 <> for an explanation on how pacman takes care of config files. + specified. This is a ``remove-then-add'' process. See <> below; also see <> 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 \n" " specify how the targets should be printed\n")); -- cgit v1.2.3-24-g4f1b