From d7ccff45b7c01c3dcf3137ff72e62a0d5c9b7fa9 Mon Sep 17 00:00:00 2001
From: Alexis <flexibeast@gmail.com>
Date: Thu, 23 Jul 2020 13:06:25 +1000
Subject: [PATCH] xbps-pkgdb.1: Add EXAMPLES section.

---
 bin/xbps-pkgdb/xbps-pkgdb.1 | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/bin/xbps-pkgdb/xbps-pkgdb.1 b/bin/xbps-pkgdb/xbps-pkgdb.1
index bab7ca053..c46ae671f 100644
--- a/bin/xbps-pkgdb/xbps-pkgdb.1
+++ b/bin/xbps-pkgdb/xbps-pkgdb.1
@@ -1,4 +1,4 @@
-.Dd June 20, 2019
+.Dd July 23, 2020
 .Dt XBPS-PKGDB 1
 .Sh NAME
 .Nm xbps-pkgdb
@@ -121,6 +121,29 @@ Default package database (0.38 format). Keeps track of installed packages and pr
 .It Ar /var/cache/xbps
 Default cache directory to store downloaded binary packages.
 .El
+.Sh EXAMPLES
+Prevent package
+.Sq foo
+from being updated during a system update:
+.Pp
+.Dl # xbps-pkgdb -m hold foo
+.Pp
+Remove hold on package
+.Sq foo :
+.Pp
+.Dl # xbps-pkgdb -m unhold foo
+.Pp
+Ensure that package
+.Sq foo
+is only updated from the same repository used to install it:
+.Pp
+.Dl # xbps-pkgdb -m repolock foo
+.Pp
+Remove the repolock on package
+.Sq foo :
+.Pp
+.Dl # xbps-pkgdb -m repounlock foo
+.Pp
 .Sh SEE ALSO
 .Xr xbps-checkvers 1 ,
 .Xr xbps-create 1 ,