From bbde59e804ee6d5bb5547071c0c59fd6cfb02d99 Mon Sep 17 00:00:00 2001
From: quazgar <quazgar@posteo.de>
Date: Fri, 28 Oct 2022 18:36:16 +0000
Subject: Documentation for autopurge command

---
 cmdline/apt-get.cc | 1 +
 cmdline/apt.cc     | 1 +
 doc/apt-get.8.xml  | 6 ++++++
 3 files changed, 8 insertions(+)

diff --git a/cmdline/apt-get.cc b/cmdline/apt-get.cc
index 010021991..95c4a85ab 100644
--- a/cmdline/apt-get.cc
+++ b/cmdline/apt-get.cc
@@ -403,6 +403,7 @@ static bool ShowHelp(CommandLine &)					/*{{{*/
 									/*}}}*/
 static std::vector<aptDispatchWithHelp> GetCommands()			/*{{{*/
 {
+   // advanced commands are left undocumented on purpose
    return {
       {"update", &DoUpdate, _("Retrieve new lists of packages")},
       {"upgrade", &DoUpgrade, _("Perform an upgrade")},
diff --git a/cmdline/apt.cc b/cmdline/apt.cc
index cc73181c0..7b56f39a6 100644
--- a/cmdline/apt.cc
+++ b/cmdline/apt.cc
@@ -55,6 +55,7 @@ static bool ShowHelp(CommandLine &)					/*{{{*/
 									/*}}}*/
 static std::vector<aptDispatchWithHelp> GetCommands()			/*{{{*/
 {
+   // advanced commands are left undocumented on purpose
    return {
       // query
       {"list", &DoList, _("list packages based on package names")},
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index c882de737..41825ad95 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -255,6 +255,12 @@
      installed to satisfy dependencies for other packages and are now no longer needed.</para></listitem>
      </varlistentry>
 
+     <varlistentry><term><option>autopurge</option></term>
+     <listitem><para>Like <literal>autoremove</literal>, but <literal>autopurge</literal> also
+     removes configuration files. This is a shortcut for <literal>autoremove
+     --purge</literal>.</para></listitem>
+     </varlistentry>
+
      <varlistentry><term><option>changelog</option></term>
 	<listitem><para><literal>changelog</literal> tries to download the
 	      changelog of a package and displays it through
-- 
cgit v1.2.3-70-g09d2