summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorChristian Blichmann <mail@blichmann.eu>2022-02-01 20:59:57 +0100
committerJulian Andres Klode <julian.klode@canonical.com>2024-04-12 15:56:56 +0200
commit690993b1b9b4a932ca5bf5374c59e4cf88f18732 (patch)
tree7620687642dc3b544e1360dbd97540db39e3a71f /doc
parent81c65f7e86b8f16eaaa91d9c205a594b0ebde159 (diff)
Columnar output for package lists similar to 'ls'
This change makes it a bit easier to quickly grasp the changes about to be performed by apt. It displays package lists in a columnar format by default, similar to what `ls` produces for files. A new long option `--no-list-columns` and an associated `APT::Get::List-Columns` config setting control the behavior. Usage example, with 60 column wide terminal: ``` $ sudo apt upgrade | Reading package lists... Done | Building dependency tree... Done | Reading state information... Done | Calculating upgrade... Done | The following packages were automatically installed and are | no longer required: | libappindicator1 libindicator7 | libdbusmenu-gtk4 linux-image-5.14.0-4-amd64 | Use 'sudo apt autoremove' to remove them. | The following packages have been kept back: | criu linux-headers-amd64 nvidia-settings | libxnvctrl0 nvidia-modprobe xwayland | 0 upgraded, 0 newly installed, 0 to remove and 6 not upgrade| d. | ``` The effect becomes more pronounced with more packages (e.g. when doing a dist-upgrade).
Diffstat (limited to 'doc')
-rw-r--r--doc/apt-get.8.xml6
-rw-r--r--doc/examples/configure-index1
2 files changed, 7 insertions, 0 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index da1e91997..807345a3d 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -410,6 +410,12 @@
Configuration Item: <literal>APT::Get::Show-Versions</literal>.</para></listitem>
</varlistentry>
+ <varlistentry><term><option>--no-list-columns</option></term>
+ <listitem><para>Display package lists without arranging them in columns. By
+ default, package lists are printed in the style of the "ls" command.
+ Configuration Item: <literal>APT::Get::List-Columns</literal>.</para></listitem>
+ </varlistentry>
+
<varlistentry><term><option>-a</option></term>
<term><option>--host-architecture</option></term>
<listitem><para>This option controls the architecture packages are built for
diff --git a/doc/examples/configure-index b/doc/examples/configure-index
index da4998b4d..9a2bcbf1c 100644
--- a/doc/examples/configure-index
+++ b/doc/examples/configure-index
@@ -104,6 +104,7 @@ APT
Show-Upgraded "<BOOL>";
Show-Versions "<BOOL>";
+ List-Columns "<BOOL>";
Upgrade "<BOOL>";
Only-Upgrade "<BOOL>";
Upgrade-Allow-New "<BOOL>";