emo/xbps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
f68893ec9a
xbps/bin/xbps-alternatives/xbps-alternatives.1

112 lines
3.0 KiB
Groff
Raw Normal View History

manpages: small formatting improvements - use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
2023-02-09 13:17:50 +05:30
.Dd Feb 9, 2023
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Dt XBPS-ALTERNATIVES 1
manpages: small formatting improvements - use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
2023-02-09 13:17:50 +05:30
.Os
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Sh NAME
.Nm xbps-alternatives
.Nd XBPS utility to handle alternatives
.Sh SYNOPSIS
manpages: small formatting improvements - use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
2023-02-09 13:17:50 +05:30
.Nm
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Op OPTIONS
.Ar MODE
.Sh DESCRIPTION
The
.Nm
utility lists or sets the alternatives provided by installed packages.
Alternatives are classified by groups, and a group contains a number
of symbolic links which are applied when the group is set.
.Pp
When a package is installed its alternative groups are registered in the package database (pkgdb).
.Pp
When a package is removed its alternative groups are unregistered from the package database (pkgdb).
If there are no more alternative groups, the package database removes the references. If there were
alternative groups registered previously, the previous package is set as default provider.
.Sh OPTIONS
.Bl -tag -width -x
.It Fl C, Fl -config Ar dir
Specifies a path to the XBPS configuration directory.
xbps-alternatives.1: fix invalid escape
2017-07-11 07:57:51 +05:30
If the first character is not '/' then it's a relative path of
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Ar rootdir .
.It Fl d, Fl -debug
Enables extra debugging shown to stderr.
.It Fl g, Fl -group
Alternative group name to match. To be used with the
.Ar set
mode.
.It Fl h, Fl -help
Show the help message.
.It Fl r, Fl -rootdir Ar dir
Specifies a full path for the target root directory.
.It Fl v, Fl -verbose
Enables verbose messages.
.It Fl V, Fl -version
Show the version information.
.El
.Sh MODE
Only one of the following modes can be used at a time.
.Bl -tag -width -x
xbps-alternatives(1): implemented -g <grp> -l.
2015-10-31 16:41:21 +05:30
.It Fl l, Fl -list Op PKG Op -g Ar group
Lists all current alternative groups or only from
.Ar PKG ,
or just a specific group, if the
.Fl g Fl -group
option is set.
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.It Fl s, Fl -set Ar PKG Op -g Ar group
Set alternative groups specified by
.Ar PKG
or just a specific group, if the
.Fl g Fl -group
option is set.
.El
.Sh FILES
.Bl -tag -width /var/db/xbps/.<pkgname>-files.plist
.It Ar /etc/xbps.d
Default configuration directory.
.It Ar /usr/share/xbps.d
Default system configuration directory.
.It Ar /var/db/xbps/.<pkgname>-files.plist
Package files metadata.
.It Ar /var/db/xbps/pkgdb-0.38.plist
Default package database (0.38 format). Keeps track of installed packages and properties.
.It Ar /var/cache/xbps
Default cache directory to store downloaded binary packages.
.El
add XBPS_SYSLOG environment variable to overwrite configuration
2021-12-28 19:46:47 +05:30
.Sh ENVIRONMENT
.Bl -tag -width XBPS_TARGET_ARCH
.It Sy XBPS_ARCH
Overrides
.Xr uname 2
machine result with this value.
.It Sy XBPS_TARGET_ARCH
Sets the target architecture to this value.
.It Sy XBPS_SYSLOG
Overrides the
.Xr xbps.d 5
.Sy syslog=true|false
configuration option.
.El
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Sh SEE ALSO
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
xbps-digest(1): new utility that replaces "xbps-uhelper digest". See the manual page: XBPS-DIGEST(1) General Commands Manual XBPS-DIGEST(1) NAME xbps-digest - XBPS utility to generate message digests SYNOPSIS xbps-digest [OPTIONS] [FILE] [FILE+N] DESCRIPTION The xbps-digest utility generates message digests for specified FILE or stdin if unset. OPTIONS -m, --mode mode Sets the message digest mode. Supported: sha256. If unset, defaults to sha256. -h, --help Show the help message. -V, --version Show the version information. SEE ALSO xbps.d(5), xbps-checkvers(1), xbps-create(1), xbps-dgraph(1), xbps-fbulk(1), xbps-install(1), xbps-pkgdb(1), xbps-query(1), xbps-reconfigure(1), xbps-remove(1), xbps-rindex(1), xbps-uchroot(1), xbps-uunshare(1) AUTHORS Juan Romero Pardines <xtraeme@gmail.com> BUGS Probably, but I try to make this not happen. Use it under your own responsibility and enjoy your life. Report bugs at https://github.com/void-linux/xbps/issues June 12, 2019 Signed-off-by: Juan RP <xtraeme@gmail.com>
2019-06-12 18:04:58 +05:30
.Xr xbps-digest 1 ,
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Xr xbps-fbulk 1 ,
xbps-fetch(1): new utility that replaces 'xbps-uhelper fetch'. xbps-install(1): document all libfetch env vars. Signed-off-by: Juan RP <xtraeme@gmail.com>
2019-06-12 21:27:03 +05:30
.Xr xbps-fetch 1 ,
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,
.Xr xbps-remove 1 ,
.Xr xbps-rindex 1 ,
.Xr xbps-uchroot 1 ,
.Xr xbps-uunshare 1 ,
.Xr xbps.d 5
.Sh AUTHORS
manpages: small formatting improvements - use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
2023-02-09 13:17:50 +05:30
.An Juan Romero Pardines Aq Mt xtraeme@gmail.com
.An Duncan Overbruck Aq Mt mail@duncano.de
Alternatives framework for xbps (2/2). See xbps-alternatives(1) for more information. Thanks to all who helped to design this and for fixing grammar in the manual page.
2015-10-30 16:54:46 +05:30
.Sh BUGS
Probably, but I try to make this not happen. Use it under your own
responsibility and enjoy your life.
.Pp
manpages: small formatting improvements - use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
2023-02-09 13:17:50 +05:30
Report bugs at
.Lk https://github.com/void-linux/xbps/issues
Reference in New Issue Copy Permalink