From c600c3eccaa20b56f2f86396ad6c80e18fc8a949 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philip=20M=C3=BCller?= Date: Sun, 17 Jun 2018 13:10:59 +0200 Subject: [PATCH] [packages] update documentation to reflect 'update_db' and 'update_system' differences --- src/modules/packages/packages.conf | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/src/modules/packages/packages.conf b/src/modules/packages/packages.conf index 84446257e..2b1942ea3 100644 --- a/src/modules/packages/packages.conf +++ b/src/modules/packages/packages.conf @@ -16,18 +16,25 @@ backend: dummy # Often package installation needs an internet connection. # Since you may allow system installation without a connection -# and want to offer **optional** package installation, it's +# and want to offer OPTIONAL package installation, it's # possible to have no internet, yet have this packages module # enabled in settings. # # You can skip the whole module when there is no internet -# by setting *skip_if_no_internet* to true. +# by setting "skip_if_no_internet" to true. # # You can run a package-manager specific update procedure # before installing packages (for instance, to update the # list of packages and dependencies); this is done only if there -# is an internet connection. Set *update_db* and/or *update_system* -# to true to do so. +# is an internet connection. +# +# Set "update_db" to 'true' for refreshing the database on the +# target system. +# +# On target installations, which got installed by unsquashing +# a full system update is may be needed, to be able to post-install +# additional packages. Therefore set also "update_system" to 'true'. +# skip_if_no_internet: false update_db: true update_system: false @@ -88,14 +95,14 @@ update_system: false # # - if the system locale is English (any variety), then the package is not # installed at all, -# - otherwise $LOCALE or ${LOCALE} is replaced by the **lower-cased** BCP47 -# name of the **language** part of the selected system locale (not the -# country/region/dialect part), e.g. selecting *nl_BE* will use *nl* +# - otherwise $LOCALE or ${LOCALE} is replaced by the 'lower-cased' BCP47 +# name of the 'language' part of the selected system locale (not the +# country/region/dialect part), e.g. selecting "nl_BE" will use "nl" # here. # # Take care that just plain LOCALE will not be replaced, so foo-LOCALE will # be left unchanged, while foo-$LOCALE will be changed. However, foo-LOCALE -# **will** be removed from the list of packages, if English is selected. +# 'will' be removed from the list of packages, if English is selected. # # The following installs localizations for vi, if they are relevant; if # there is no localization, installation continues normally.