From 8c86d5fc940f19b6908f731d334a6f3be0d027d0 Mon Sep 17 00:00:00 2001
From: Gábor Németh <homar@riseup.net>
Date: Fri, 15 Dec 2023 12:57:54 +0100
Subject: Document 'dist-clean'

cf. https://salsa.debian.org/apt-team/apt/-/merge_requests/312#note_453588
---
 doc/apt-get.8.xml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index 3b8df6422..3779b18b9 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2024-01-08T00:00:00Z</date>
+   <date>2024-01-10T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
@@ -250,6 +250,13 @@
      erased if it is set to off.</para></listitem>
      </varlistentry>
 
+     <varlistentry><term><option>distclean</option> (and the <option>dist-clean</option> alias)</term>
+     <listitem><para><literal>distclean</literal> removes all files under
+     <filename>&statedir;/lists</filename> except Release, Release.gpg, and InRelease.
+     It can be used for example, when finalizing images distributed to users.
+     The release files are kept for security reasons, to prevent various types of attacks.</para></listitem>
+     </varlistentry>
+
      <varlistentry><term><option>autoremove</option> (and the <option>auto-remove</option> alias since 1.1)</term>
      <listitem><para><literal>autoremove</literal> is used to remove packages that were automatically
      installed to satisfy dependencies for other packages and are now no longer needed.</para></listitem>
-- 
cgit v1.2.3-70-g09d2