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).
This commit is contained in:
Roman Neuhauser 2016-09-20 09:13:01 +02:00
parent 7d06fb0e71
commit 025b133025

View File

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