1 files changed, 4 insertions, 1 deletions

diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index b56ad6b5..b288a592 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -327,7 +327,10 @@ linkman:pacman.conf[5].
 	report of all packages to upgrade will be presented and  the operation
 	will not proceed without user confirmation. Dependencies are
 	automatically resolved at this level and will be installed/upgraded if
-	necessary.
+	necessary. Pass this option twice to enable package downgrade; in this
+	case pacman will select sync packages whose version does not match with
+	the local version. This can be useful when the user switches from a testing
+	repo to a stable one.
 
 *-w, \--downloadonly*::
 	Retrieve all packages from the server, but do not install/upgrade