From 05588a1ffd6419778d8ccb4a55a9d6b49406a476 Mon Sep 17 00:00:00 2001 From: Adriaan de Groot Date: Tue, 27 Nov 2018 12:39:19 +0100 Subject: [PATCH] [packages] Improvide conf documentation - about LOCALE packages - about pre- and post-scripts CC: #1057 --- src/modules/packages/packages.conf | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/src/modules/packages/packages.conf b/src/modules/packages/packages.conf index 974ba07a7..40701841e 100644 --- a/src/modules/packages/packages.conf +++ b/src/modules/packages/packages.conf @@ -89,20 +89,25 @@ update_system: false # "package: vi" with neither script option will trick Calamares into # trying to install a package named "package: vi", which is unlikely to work. # +# Pre- and post-scripts are supported only in the install and try_install +# operations. +# # Any package name may be localized; this is used to install localization # packages for software based on the selected system locale. By including -# the string LOCALE in the package name, the following happens: +# the string `LOCALE` in the package name, the following happens: # # - 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 +# - 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. +# 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 (i.e. not installed), if +# English is selected. If a non-English locale is selected, then `foo-LOCALE` +# will be installed, unchanged (no language-name-substitution occurs). # # The following installs localizations for vi, if they are relevant; if # there is no localization, installation continues normally.