summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulian Andres Klode <jak@debian.org>2025-05-19 14:17:23 +0200
committerJulian Andres Klode <jak@debian.org>2025-05-19 15:20:09 +0000
commit7724d170751b3dc1717ba7a08881437cf7151996 (patch)
tree9f76923fbd5b856904a414fa615116940d2afff6 /doc
parent2ddc16b9f8edff1329f5ac3e46b0c0cf9bde661d (diff)
Introduce apt why, apt why-not
These are implemented somewhat differently from aptitudes why and why-not commands: They produce the actual solver trace for why a particular decision has been taken. For the why-not case, we need to explicitly discover our specified package, as if nothing else depends on it in our graph, it would otherwise always be undiscovered and conflicts not detected (see e.g. level-3 in the test).
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