From 66ec0dfad8ac1d4d8646a4734eb9353f3ebc0a91 Mon Sep 17 00:00:00 2001 From: Daniel Lublin Date: Thu, 29 May 2025 22:29:21 +0200 Subject: doc: Increase visibility of special signs' usage Closes: #310975 Signed-off-by: Daniel Lublin --- doc/apt-get.8.xml | 10 +++++----- doc/apt.8.xml | 6 +++--- doc/apt.conf.5.xml | 2 +- 3 files changed, 9 insertions(+), 9 deletions(-) (limited to 'doc') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 93f02a5a7..e185505fc 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -104,17 +104,17 @@ by the package(s) specified for installation will also be retrieved and installed. The /etc/apt/sources.list file is - used to locate the desired packages. If a hyphen 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 + 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 + following the package name with an equals sign (=) 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 @@ -157,7 +157,7 @@ remove is identical to install except that packages are removed instead of installed. Note that removing a package leaves its - configuration files on the system. If a plus sign is appended to the package + configuration files on the system. If a plus sign (+) is appended to the package name (with no intervening space), the identified package will be installed instead of removed. @@ -193,7 +193,7 @@ will not be unpacked. A specific source version can be retrieved by postfixing the source name - with an equals and then the version to fetch, similar to the mechanism + with an equals sign (=) and then the version to fetch, similar to the mechanism used for the package files. This enables exact matching of the source package name and version, implicitly enabling the APT::Get::Only-Source option. diff --git a/doc/apt.8.xml b/doc/apt.8.xml index 2c1256dce..0a9cb292f 100644 --- a/doc/apt.8.xml +++ b/doc/apt.8.xml @@ -76,11 +76,11 @@ , , , (&apt-get;) Performs the requested action on one or more packages specified via ®ex;, &glob; or exact match. The requested action - can be overridden for specific packages by appending a plus (+) to the - package name to install this package or a minus (-) to remove it. + can be overridden for specific packages by appending a plus sign (+) to the + package name to install this package or a minus sign (-) to remove it. A specific version of a package can be selected for installation by - following the package name with an equals (=) and the version of the + following the package name with an equals sign (=) and the version of the package to select. Alternatively the version from a specific release can be selected by following the package name with a forward slash (/) and codename (&debian-stable-codename;, &debian-testing-codename;, sid …) or suite name (stable, diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 18379ac19..45b306f82 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -129,7 +129,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; All of the APT tools take an -o option which allows an arbitrary configuration directive to be specified on the command line. The syntax is a full option name (APT::Get::Assume-Yes for instance) followed by an equals - sign then the new value of the option. To append a new element to a list, add a + sign (=) then the new value of the option. To append a new element to a list, add a trailing :: to the name of the list. (As you might suspect, the scope syntax can't be used on the command line.) -- cgit v1.2.3-70-g09d2