Bug#338790: apt-get: man page should mention "=" and "/"
I suggest that the paragraph include examples, such as the following.
- Jim Van Zandt
--- apt-get.8-orig 2006-06-08 22:53:07.000000000 -0400
+++ apt-get.8 2006-06-08 22:59:28.000000000 -0400
@@ -56,7 +56,7 @@
install
install is followed by one or more packages desired for installation\&. Each package is a package name, not a fully qualified filename (for instance, in a Debian GNU/Linux system, libc6 would be the argument provided, not libc6_1\&.9\&.6\-2\&.deb) All packages required by the package(s) specified for installation will also be retrieved and installed\&. The \fI/etc/apt/sources\&.list\fR file is used to locate the desired packages\&. If a hyphen is appended to the package name (with no intervening space), the identified package will be removed if it is installed\&. Similarly a plus sign can be used to designate a package to install\&. These latter features may be used to override decisions made by apt\-get's conflict resolution system\&.
-A specific version of a package can be selected for installation by following the package name with an equals and the version of the package to select\&. This will cause that version to be located and selected for install\&. Alternatively a specific distribution can be selected by following the package name with a slash and the version of the distribution or the Archive name (stable, testing, unstable)\&.
+A specific version of a package can be selected for installation by following the package name with an equals and the version of the package to select, for example "apt-get install grep=2.5.1.ds2-4"\&. This will cause that version to be located and selected for install\&. Alternatively a specific distribution can be selected by following the package name with a slash and the version of the distribution or the Archive name, for example "apt-get install grep/unstable"\&.
Both of the version selection mechanisms can downgrade packages and must be used with care\&.
Reply to: