emo/xbps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Improve description of keepconf option

Browse Source 
keepconf is a boring option and is not needed in most situations. Make
this more clear in the documentation, e.g. that it only affects
*unchanged* configuration files, and that changed configuration files
are unaffected by this option.
This commit is contained in:
Merlin Büge 2021-12-26 07:24:35 +01:00 committed by Duncan Overbruck
parent 14c762afeb
commit 24cb1709c7
2 changed files with 15 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
data/xbps.conf
View File

@ -71,19 +71,20 @@
# preserve=/etc/file # preserve=/etc/file
# preserve=/etc/dir/*.conf # preserve=/etc/dir/*.conf
## PRESERVING CONFIGURATION ## PRESERVING UNCHANGED CONFIGURATION FILES
# #
# The `keepconf` (disabled by default) keyword can be used to prevent # The `keepconf` (disabled by default) keyword can be used to prevent
# xbps from overwriting configuration files. # xbps from overwriting unchanged configuration files. Changed configuration
# files are unaffected by this keyword and are preserved by default.
# #
# If set to false, xbps will overwrite configuration files if they # If set to false, xbps will overwrite configuration files that have not been
# have not been changed since installation and a newer version is # changed since installation with their new version (if available).
# available.
# #
# If set to true, xbps will save the new configuration file as # If set to true, xbps will not overwrite configuration files that have not
# <name>.new-<version> if the original configuration file has not been # been changed since installation. Instead, the new version (if available) is
# changed since installation. # saved next to the configuration file as <name>.new-<version>.
# keepconf=true #
#keepconf=true
## VIRTUAL PACKAGES ## VIRTUAL PACKAGES
# #

11
data/xbps.d.5
View File

@ -96,13 +96,12 @@ Absolute path to a file and file globbing are supported, example:
.It Sy preserve=/etc/foo/*.conf .It Sy preserve=/etc/foo/*.conf
.El .El
.It Sy keepconf=true|false .It Sy keepconf=true|false
If set to false (default), xbps will overwrite configuration files if If set to false (default), xbps will overwrite configuration files that have
they have not been changed since installation and a newer version is not been changed since installation with their new version (if available).
available.
.Pp .Pp
If set to true, xbps will save the new configuration file as If set to true, xbps will not overwrite configuration files that have not
<name>.new-<version> if the original configuration file has not been been changed since installation. Instead, the new version (if available) is
changed since installation. saved next to the configuration file as <name>.new-<version>.
.Pp .Pp
.It Sy repository=url .It Sy repository=url
Declares a package repository. The Declares a package repository. The