xbps-pkgdb.1: Add EXAMPLES section.

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 ,