man: enhance install/uninstall section

openSUSE · Aug 12, 2016 · e1bb3e4 · e1bb3e4
1 parent 1ee6ee5
commit e1bb3e4
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 16 deletions.
diff --git a/doc/zypper.8 b/doc/zypper.8
@@ -2,12 +2,12 @@
 .\"     Title: zypper
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\"      Date: 07/26/2016
+.\"      Date: 08/12/2016
 .\"    Manual: ZYPPER
 .\"    Source: SUSE Linux
 .\"  Language: English
 .\"
-.TH "ZYPPER" "8" "07/26/2016" "SUSE Linux" "ZYPPER"
+.TH "ZYPPER" "8" "08/12/2016" "SUSE Linux" "ZYPPER"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -355,19 +355,15 @@ Zypper will download the files into its cache directory (/var/cache/zypper/RPMS)
 repository and mark the respective packages for installation\&.
 .RE
 .PP
-In the install command, you can specify also packages you wish to remove in addition to the packages you wish to install, by prepending their names by a \fI\-\fR or \fI~\fR character\&. For example:
+In the install command, you can also specify packages you wish to remove by prepending their names by a \fI\-\fR or \fI!\fR character\&. For example:
 .RS 4
 
 $
-\fI\fBzypper install vim \-emacs\fR\fR\ \&
+\fBzypper install \e!Firefox\fR\ \&
 
-$
-\fBzypper remove emacs +vim\fR\ \&
-
-will both
-\fIinstall vim\fR
-and
-\fIremove emacs\fR\&. Note that if you choose to use
+In contrast to
+\fBzypper remove Firefox\fR
+which removes Firefox and its dependent packages, the install command will try to keep dependent packages installed by looking for Firefox alternatives\&. + Note that if you choose to use
 \fB\-\fR
 with the first package you specify, you need to write
 \fB\-\-\fR
@@ -684,6 +680,9 @@ This command also accepts the \fBDownload\-and\-install mode options\fR describe
 .RS 4
 Remove (uninstall) packages\&.
 
+The remove command will uninstall the selected and their dependent packages\&. It will not try to install alternatives in order to keep dependent packages installed\&. If you want this, use
+\fBzypper install !\fR\fB\fIname\fR\fR\&.
+
 The packages can be selected by their name or by a capability they provide\&. For details on package selection see the
 \fBinstall\fR
 command description\&.

diff --git a/doc/zypper.8.txt b/doc/zypper.8.txt
@@ -196,13 +196,12 @@ Package Management Commands
 		+
 		Zypper will download the files into its cache directory (/var/cache/zypper/RPMS), add this directory as a temporary *plaindir* repository and mark the respective packages for installation.
 
-	In the install command, you can specify also packages you wish to remove in addition to the packages you wish to install, by prepending their names by a '-' or '~' character. For example: ;;
+	In the install command, you can also specify packages you wish to remove by prepending their names by a '-' or '!' character. For example: ;;
 		+
-		$ '*zypper install vim -emacs*'{nbsp}
+		$ *zypper install \!Firefox*{nbsp}
 		+
-		$ *zypper remove emacs +vim*{nbsp}
-		+
-		will both 'install vim' and 'remove emacs'. Note that if you choose to use *-* with the first package you specify, you need to write *--* before it to prevent its interpretation as a command option:
+		In contrast to *zypper remove Firefox* which removes Firefox and its dependent packages, the install command will try to keep dependent packages installed by looking for Firefox alternatives.
+		+ Note that if you choose to use *-* with the first package you specify, you need to write *--* before it to prevent its interpretation as a command option:
 		+
 		$ *zypper install -- -boring-game great-game great-game-manual*{nbsp}
 
@@ -382,6 +381,8 @@ Package Management Commands
 *remove* (*rm*) ['options'] *--capability* 'capability'...::
 	Remove (uninstall) packages.
 	+
+	The remove command will uninstall the selected and their dependent packages. It will not try to install alternatives in order to keep dependent packages installed. If you want this, use *zypper install !'name'*.
+	+
 	The packages can be selected by their name or by a capability they provide. For details on package selection see the *install* command description.
 +
 --