Merge pull request #198 from roman-neuhauser/package-modes

xbps-pkgdb(1), xbps-install(1), xbps-remove(1): extend discussion of package modes

bin/xbps-install/xbps-install.1

@@ -1,4 +1,4 @@
-.Dd October 28, 2015
+.Dd September 20, 2016
 .Dt XBPS-INSTALL 1
 .Sh NAME
 .Nm xbps-install
@@ -59,6 +59,7 @@ The first repository matching the package expression wins.
 .It Fl A, Fl -automatic
 Enables automatic installation mode, i.e. package will be treated as orphan
 if no package is depending on it directly.
+.No See Fl -mode Sy auto No in Xr xbps-pkgdb 1 .
 .It Fl C, Fl -config Ar dir
 Specifies a path to the XBPS configuration directory.
 If the first character is not '\/' then it's a relative path of
@@ -112,7 +113,9 @@ If set, packages to be installed or upgraded in the transaction won't be configu
 just unpacked. That means that those packages should be reconfigured via
 .Xr xbps-reconfigure 1 .
 .It Fl u, Fl -update
-Performs a full system upgrade: all installed packages will be updated to the greatest
+Performs a full system upgrade: all installed packages
+.Pq except those on Sy hold , No see Fl -mode Sy hold No in Xr xbps-pkgdb 1
+will be updated to the greatest
 versions that were found in repositories.
 .It Fl v, Fl -verbose
 Enables verbose messages.

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

bin/xbps-remove/xbps-remove.1

@@ -83,6 +83,7 @@ Cleans cache directory removing obsolete binary packages.
 .It Fl o, Fl -remove-orphans
 Removes installed package orphans that were installed automatically
 (as dependencies) and are not currently dependencies of any installed package.
+.No See Fl -mode Sy auto No in Xr xbps-pkgdb 1 .
 .It Fl R, Fl -recursive
 Recursively remove packages that were installed by
 .Ar PKGNAME