From 1c8aa58aaef968382d3afa4f2871f13b688aae60 Mon Sep 17 00:00:00 2001
From: Mateusz Piotrowski <0mp@FreeBSD.org>
Date: Sun, 27 May 2018 01:59:43 +0200
Subject: [PATCH] Improve the explanation of the --all option

---
 docs/pkg-clean.8 | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/pkg-clean.8 b/docs/pkg-clean.8
index a7bda821c5..cf469d2a29 100644
--- a/docs/pkg-clean.8
+++ b/docs/pkg-clean.8
@@ -14,7 +14,7 @@
 .\"
 .\"     @(#)pkg.8
 .\"
-.Dd October 30, 2014
+.Dd May 27, 2018
 .Dt PKG-CLEAN 8
 .Os
 .Sh NAME
@@ -37,7 +37,8 @@ The following options are supported by
 .Nm :
 .Bl -tag -width F1
 .It Fl a , Fl -all
-Delete all cached packages.
+Delete all cached packages including those, which have not been superseded by
+newer versions yet and are still in use.
 .It Fl n , Fl -dry-run
 Do not delete any package files from the cache, but show what
 would be done instead.