summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulian Andres Klode <jak@debian.org>2025-05-19 15:21:03 +0000
committerJulian Andres Klode <jak@debian.org>2025-05-19 15:21:03 +0000
commitd0ecc3286b4487d3b3f2809c95233863bffdada5 (patch)
tree9f76923fbd5b856904a414fa615116940d2afff6 /doc
parent2ddc16b9f8edff1329f5ac3e46b0c0cf9bde661d (diff)
parent7724d170751b3dc1717ba7a08881437cf7151996 (diff)
Merge branch 'feature/why' into 'main'
Introduce apt why, apt why-not See merge request apt-team/apt!479
Diffstat (limited to 'doc')
-rw-r--r--doc/apt.8.xml11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/apt.8.xml b/doc/apt.8.xml
index 7af915e89..8dd1d019b 100644
--- a/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@ -121,6 +121,17 @@
</para></listitem>
</varlistentry>
+ <varlistentry><term><option>why, why-not</option></term>
+ <listitem>
+ <para>These commands print the reasoning path from the solver. They are similar to the equivalent aptitude commands for many use cases, but are different in that they print the actual reason the solver picked rather than the potential strongest path.</para>
+ <para>The <option>why</option> command determines why an installed package is installed. This
+ provides reasonable feedback as to why an automatically installed package is installed; for a
+ manually installed package no other reason is given. If the package is not installed, no reason
+ can be determined.</para>
+ <para>The <option>why-not</option> command determines why a package was determined to not be installable. This
+ may not always yield a result, even if a package is uninstallable.</para>
+ <para>Both commands take a single argument, the name of a package.</para>
+ </listitem></varlistentry>
<varlistentry><term><option>search</option> (&apt-cache;)</term>
<listitem><para><option>search</option> can be used to search for the given