From 025b1330252a2ed984a64695124969ffb2c55a22 Mon Sep 17 00:00:00 2001
From: Roman Neuhauser <neuhauser@sigpipe.cz>
Date: Tue, 20 Sep 2016 09:13:01 +0200
Subject: [PATCH] xbps-pkgdb(1): extend discussion of package modes

description of implications of the various modes was scattered across
xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
---
 bin/xbps-pkgdb/xbps-pkgdb.1 | 55 +++++++++++++++++++++++++++++--------
 1 file changed, 43 insertions(+), 12 deletions(-)

diff --git a/bin/xbps-pkgdb/xbps-pkgdb.1 b/bin/xbps-pkgdb/xbps-pkgdb.1
index f6669cb6..7c4d5b37 100644
--- a/bin/xbps-pkgdb/xbps-pkgdb.1
+++ b/bin/xbps-pkgdb/xbps-pkgdb.1
@@ -1,4 +1,4 @@
-.Dd October 28, 2015
+.Dd September 20, 2016
 .Dt XBPS-PKGDB 1
 .Sh NAME
 .Nm xbps-pkgdb
@@ -48,23 +48,54 @@ Enables extra debugging shown to stderr.
 .It Fl h, Fl -help
 Show the help message.
 .It Fl m, Fl -mode Ar auto|manual|hold|unhold|repolock|repounlock
-Switches
-.Ar PKGNAME
-to the specified  mode: automatic or manual installation mode, or to (un)set the on hold mode,
-and repository locked mode.
-A package that was installed as dependency will be in
+.
+.Bl -tag -width -x
+.
+.It Sy auto , manual
+.Sy auto No marks each Ar PKGNAME
+as
+.Sy automatic -
+as if it was installed implicitly as a dependency of another package.
+.Sy manual No marks each Ar PKGNAME
+as if it was installed explicitly as an operand to
+.Xr xbps-install 1 .
 .Sy automatic
-mode, otherwise will be set to
-.Sy manual .
-A package in
-.Sy hold
-mode won't be updated in full system upgrades. The list of packages in this mode can be
-seen with
+packages are considered for removal by
+.Nm xbps-remove Fl -remove-orphans ;
+see also
+.Fl -list-manual-pkgs ,
+.Fl -list-orphans
+in
 .Xr xbps-query 1 .
+.
+.It Sy hold , unhold
+Set or unset the
+.Sy hold
+mode for each
+.Ar PKGNAME .
+.Nm xbps-install Fl u
+does not update packages on
+.Sy hold ;
+see also
+.Fl -list-hold-pkgs
+in
+.Xr xbps-query 1 .
+.
+.It Sy repolock , repounlock
+Set or unset the
+.Sy repolock
+mode for each
+.Ar PKGNAME .
 A package in
 .Sy repolock
 mode will only accept updates that are available in the same repository that was used
 for installing.
+See also
+.Fl -list-repolock-pkgs
+in
+.Xr xbps-query 1 .
+.El
+.
 .It Fl r, Fl -rootdir Ar dir
 Specifies a full path for the target root directory.
 .It Fl u, Fl -update