Merge branch 'doc-signs' into 'main'

doc: Increase visibility of special signs' usage

See merge request apt-team/apt!487

3 files changed, 9 insertions, 9 deletions

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 <filename>/etc/apt/sources.list</filename> file is 
-	 used to locate the desired packages. If a hyphen is 
+	 used to locate the desired packages. If a hyphen (<literal>-</literal>) 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 (<literal>+</literal>) 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.
 	 </para>
 
      <para>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 (<literal>=</literal>) 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 @@
      <varlistentry><term><option>remove</option></term>
      <listitem><para><literal>remove</literal> is identical to <literal>install</literal> 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 (<literal>+</literal>) is appended to the package 
      name (with no intervening space), the identified package will be 
      installed instead of removed.</para></listitem>
      </varlistentry>
@@ -193,7 +193,7 @@
      will not be unpacked.</para>
 
      <para>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 (<literal>=</literal>) 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 
      <literal>APT::Get::Only-Source</literal> option.</para>
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 @@
      <varlistentry><term><option>install</option>, <option>reinstall</option>, <option>remove</option>, <option>purge</option> (&apt-get;)</term>
      <listitem><para>Performs the requested action on one or more packages
 	   specified via &regex;, &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 (<literal>+</literal>) to the
+	   package name to install this package or a minus sign (<literal>-</literal>) to remove it.
      </para><para>
 	   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 (<literal>=</literal>) 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";};
    <para>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 (<literal>APT::Get::Assume-Yes</literal> 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 (<literal>=</literal>) then the new value of the option. To append a new element to a list, add a
    trailing <literal>::</literal> to the name of the list.
    (As you might suspect, the scope syntax can't be used on the command line.)</para>