<!-- SPDX-FileCopyrightText: no
     SPDX-License-Identifier: CC0-1.0
-->

This is the changelog for Calamares. For each release, the major changes and
contributors are listed. Note that Calamares does not have a historical
changelog -- this log starts with version 3.2.0. The release notes on the
website will have to do for older versions.

# 3.2.36 (unreleased) #

This release contains contributions from (alphabetically by first name):
 - Anubhav Choudhary
 - Gaël PORTAY

## Core ##
 - It is now possible to hide the *next* and *back* buttons during
   the "exec" phase of installation. THanks Anubhav.

## Modules ##
 - *partition* includes more information about what it will do, including
   GPT partition types (in human-readable format, if possible). Thanks Gaël.
 - Some edge-cases with overlay filesystems have been resolved in the
   *partition* module. Thanks Gaël.
 - During the creation of filesystems and partitions, automounting is
   turned off (if DBus is available, and the host system supports
   KDE Solid automount control). This should reduce the number of
   failed installations if automount grabs partitions while they are
   being created. The code is prepared to handle other ways to control
   automount-behavior as well.


# 3.2.35.1 (2020-12-07) #

This release contains contributions from (alphabetically by first name):
 - Anubhav Choudhary
 - Matti Hyttinen

Some strange string artifacts appeared, leading to `{1?}` being
displayed in various user-facing messages. These have been removed
and the translations updated.

## Modules ##
 - The *initcpiocfg* module would sometimes configure the system to ask
   for a passphrase, when none is needed.


# 3.2.35 (2020-11-30) #

This release contains contributions from (alphabetically by first name):
 - Clarissa Borges
 - Matti Hyttinen

A new kind of issue template has been added for Calamares,
for reporting (and adding tests for) usability issues. Thanks
to Clarissa for leading that effort.

## Core ##
 - No core changes yet

## Modules ##
 - The *partition* module now supports a not-full-disk-encryption setup,
   where `/boot` is not encrypted, but the rest of the system is.
 - The *plasmalnf* module has been substantially rewritten, so that it
   can support a QML version of the module in future. The UI has changed
   a little, and now displays more themes than before.


# 3.2.34 (2020-11-16) #

This release contains contributions from (alphabetically by first name):
 - Artem Grinev
 - Gaël PORTAY

## Core ##
 - No core changes yet

## Modules ##
 - The *keyboard* module had a regression in which it no-longer painted
   the keycaps in the keyboard preview. (reported by Vinnie)
 - The *plasmalnf* module did not set all of the look-and-feel values
   in the target system. (reported by Bluestar Linux)
 - In the *users* module, warnings about the strength of the password
   are now correctly pluralized when possible.
 - In the *users* module, if ICU is installed, the user's full name is
   automatically transliterated to US-ASCII (for some locales; this will
   need tweaking) so that the login name is acceptable. (Thanks Artem)


# 3.2.33 (2020-11-09) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Andrius Štikonas
 - Artem Grinev
 - Gaël PORTAY
 - Matti Hyttinen
 - TTran Me

## Core ##
 - Calamares now sets the C++ standard for compilation to C++17; this
   is for better compatibility and fewer warnings when building with
   modern KDE Frameworks and KPMcore 4.2.0.
 - Vietnamese translations have been added. Welcome! (Thanks TTran)

## Modules ##
 - The *initcpiocfg* module should support plymouth with encryption
   now. (Thanks Matti)
 - The *keyboard* and *keyboardq* modules now share backend code
   and handle non-ASCII layouts better (for setting passwords
   and usernames). (Thanks Artem)
 - Various cleanups and documentation improvements in the *partition*
   module, and configurable GPT name for swap. (Thanks Gaël)
 - A long-standing bug related to GPT partition flags in the
   *partition* module has been resolved. #1327 #1267
 - The *users* module now has a more detailed way to specify
   user groups -- which may be system groups rather than user-GIDs.
   A new option in each group can require that the group already
   exists in the target system, allowing for better consistency checks
   with the squashfs. #1523


# 3.2.32.1 (2020-10-17) #

This is a release to address source-incompatible changes in KPMcore 4.2.0,
which was released just before Calamares 3.2.32 and had not yet been
compile-tested. There is also one changed message in the translations,
reported by Yuri Chornoivan.


# 3.2.32 (2020-10-16) #

This release contains contributions from (alphabetically by first name):
 - Fabian Tomat
 - Gaël PORTAY

## Core ##
 - When doing GeoIP lookups, Calamares pretends to be Firefox.
   This resolves an issue where the GeoIP provider was refusing
   QNAM connections with the default User-Agent.
 - New translation available, Friulian. Welcome!

## Modules ##
 - The *netinstall* module has some tricky configuration files;
   it now complains about more cases of bad syntax or poor structure.
 - The *partition* module can now be constrained to work only with
   a particular kind of partition table. (thanks Gaël)
 - The *partition* module is a little more resilient to variations
   in btrfs notation from os-prober.
 - The *shellprocess* module now supports having a different progress
   message (other than "Shell Processes Job") through the config file.


 # 3.2.31 (2020-10-06) #

This release contains contributions from (alphabetically by first name):
 - Corentin Noël
 - kadler15 (new contributor! hi!)

## Core ##
 - At the start of the *exec* phase, an overview is given of the
   various job weights, which allows you to tweak the overall
   progress reporting during the installation.
 - Problems with running Calamares on a 1-core single CPU have been resolved.

## Modules ##
 - The *keyboard* module now recognizes Turkish "F" layout and
   will set the vconsole keyboard layout correctly even if xkb
   keymaps are not found.
 - The *machineid* module, which generates UUIDs for systemd and dbus
   and can generate entropy files (filled from `/dev/urandom` in the host
   system) now supports more than one entropy file; generate them as needed
   (or copy a fixed value to all, depending on *entropy-copy*). Deprecate
   *entropy* (which generates a specific output file) as too inflexible.
 - In the *partition* module, swap can now be chosen as *file*, which is
   **not** create a swap partition, but write a `/swapfile` in the root
   directory, 512MiB large, and set that as swap. There is as yet no
   "smarts" about the size of the swap file.
 - Multiple problems in the *partition* module around partition
   sizing have been resolved by Corentin Noël.
 - The *preservefiles* module documentation did not match the functionality,
   and when used, didn't work right. #1521 (thanks kadler15)
 - Progress reporting from the *unpackfs* module has been revamped:
   it reports more often now, so that it is more obvious that files
   are being transferred even when the percentage progress does not
   change.
 - The *unpackfs* module now supports a *weight* setting for each
   of the unpack entries. For a single entry this does not matter,
   but if there are multiple entries it allows tweaking the relative
   progress between each entry.


# 3.2.30 (2020-09-03) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Asif Mahmud Shimon
 - Manzoor Ahmed Munawar
 - Sai Kamal
 - Victor Ibragimov

This release has two giant source-code changes that have no effect
on functionality, but do touch each and every source file:
 - SPDX headers for licensing information, following the standard
   set by REUSE.software ; all source files and resources have
   SPDX-License-Identifier information and copyright notices. All
   of the boilerplate texts have been removed.
 - Calamares coding style has been mechanically applied to the entire
   codebase. This was already done to most of it, but there were
   some hold-outs.

## Core ##
 - Network access status is deprecated in Qt 5.15's QNetworkAccessManager,
   and was not useful already in some previous versions. Replace its
   use in the Calamares network service by testing-it-ourself directly
   via a synchronous ping. (Thanks to Asif)
 - New Telugu translation. (Thanks to Sai)
 - Urdu translation started. (Thanks to Manzoor)
 - Timezones translated in Tajik and Russian. (Thanks to Victor)

## Modules ##
 - *keyboardq* and *localeq* improvements. (Thanks to Anke)
 - *users* module did not set up autologin properly. This is yet another
   regression left over from 3.2.28. (Reported by Phil and pcrepix, #1498)
 - *welcome* module now sets the *LANG* key in the locale configuration
   (which is shared with the *locale* module and consumed by the
   *localecfg* module). This makes it feasible to drop the *locale*
   module and still set the installed system's language to the language
   selected in Calamares. (Reported by FerenOS)


# 3.2.29 (2020-08-20) #

This release contains contributions from (alphabetically by first name):
 - Asif Mahmud Shimon (new contributor! hi!)

## Core ##
 - Edge case in extracting string-lists from YAML, reported and fixed
   by Asif (#1491).
 - Progress reporting is now more flexible. Modules can have a weight
   assigned to them in the descriptor; module instances can have a weight
   assigned which overrides the module descriptor. When jobs are run
   for a module instance, the jobs report progress pro-rated by the
   module's weight. Or in other words, it is now possible to tweak
   the amount of the overall progress bar that different modules fill.
   The default settings give unpackfs a weight of 12. (#1176)

## Modules ##
 - The *users* module did not read the *defaultGroups* correctly.
   Fixed by the string-lists change mentioned above.


 # 3.2.28.3 (2020-08-18) #

Another hotfix, for more issues reported by Marco Obaid. Users
were not having a password set (#1489)


# 3.2.28.2 (2020-08-12) #

A second hotfix, for autologin support -- the autologin group was not
created in the target system before assigning the user to it. Reported
by Marco Obaid.


# 3.2.28.1 (2020-08-10) #

This is a hotfix release for #1482 and #1483, where no user was
created during installation and a chmod was failing (resulting in
a failed installation). Reported by Jonathan Riddell.

With incidental improvements in SPDX tagging (code licensing)
and some new icon options for the welcomeq and localeq modules.


# 3.2.28 (2020-08-09) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - apt-ghetto
 - Victor Ibragimov

## Core ##
 - A new object *Network* is available to QML modules in `io.calamares.core`.
   It exposes network status through the *hasInternet* property.
 - Welcome to Tajik translations. The Tajik language has quickly reached
   100% completion. Thanks Victor!
 - Welcome to [Interlingue](https://en.wikipedia.org/wiki/Interlingue).
   The translation is at an early stage. Qt does not support language
   code *ie* though, so it may take some time to be integrated (much
   like Esperanto wasn't supported until Qt 5.12).

## Modules ##
 - The *locale* module has been completely redone on the inside.
   Users should see no changes. #1391
 - The *localeq* module uses the redone internals of the locale module.
   It can now be used to set timezone, language and locale information
   and is a suitable alternative module. Thanks to Anke Boersma who did
   the work of figuring out maps. Note that the map uses several GeoIP
   and GeoData providers and you may need to configure the URLs
   with suitable usernames for those services. #1426
 - Both *locale* and *localeq* can now be configured to use the system's
   timezone setting -- this can be useful to avoid both hard-coding an
   initial zone and doing extra GeoIP lookups, in the case where the
   live system already does so. #1391
 - The *locale* and *localeq* modules have additional machinery for
   timezone lookups; please report cases where clicking on the map
   returns an obviously bogus timezone (up until this release, for
   instance, Cape Town).
 - The *users* module no longer accepts `root` as a username. #1462
 - The *keyboardq* module is now more inline with the look of the rest
   of the Calamares modules, use of a background image is removed.
 - The *grubcfg* module now understands `/etc/default/grub.d`. #1457


# 3.2.27 (2020-07-11) #

This release contains contributions from (alphabetically by first name):
 - Gaël PORTAY
 - Vitor Lopes (new! welcome!)

## Core ##
 - QML modules with no surrounding navigation -- this is basically a
   special case for full-screen Calamares -- now have margins suitable
   for full-screen use.
 - PythonQt modules are increasingly on the way out.

## Modules ##
 - The Manjaro package manager *pamac* has been added to those supported by
   the *packages* module.
 - The *netinstall* module has had some minor UI tweaks.
 - Partitioning now tries harder to avoid floppy drives.


# 3.2.26.1 (2020-06-23) #

This is a hotfix release for undefined behavior caused by an
uninitialized integer variable. It includes new translations
and features as well since those arrived independently.

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Gaël PORTAY

## Core ##
 - Welcome to Azerbaijani translations. These are available
   in two variations, *Azerbaijani* and *Azerbaijani (Azerbaijan)*.
   [Wikipedia Azerbaijani](https://en.wikipedia.org/wiki/Azerbaijani_language#North_vs._South_Azerbaijani)
   has a nice overview.
 - Warnings while building with Qt 5.15 have been much reduced.

## Modules ##
 - *partitioning* has one case of undefined behavior (UB) due
   to a missing integer-initialization. (Thanks Gaël)
 - *keyboardq* QML module now works correctly. (Thanks Anke)


# 3.2.26 (2020-06-18) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Gaël PORTAY
 - Pablo Ovelleiro Corral
 - Philip Müller

## Core ##
 - The default branch for Calamares source repositories (calamares
   and calamares-extensions) is now *calamares*.
 - External modules can now be built again, outside of the Calamares
   source and build-tree.
 - The repository *calamares-tools* has been removed. The idea behind
   the tooling was to provide schema validation for Calamares configuration
   files. This has been merged into the primary repository, where it
   is now part of the test suite.

## Modules ##
 - *locale* put some more places into the correct timezone **visually**;
   for instance Norfolk Island gave up UTC+11.5 in 2015 and is now
   UTC+11, but Calamares still showed it in a zone separate from UTC+11.
 - *localeq* can now properly switch between on & offline mode,
   it detects internet status through js.
 - *packages* gained support for the Void Linux package manager,
   *xbps*. (thanks Pablo)
 - *tracking* now supports kuserfeedback configuration.
 - *welcomeq* added the GEOIP configuration option, so locale can be
   initially set according to IP address.


# 3.2.25 (2020-06-06) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Callum Farmer
 - FLVAL
 - Gaël PORTAY

## Core ##
 - The slideshow in `branding.desc` can be configured with QML (recommended,
   as it has been for the past umpteen releases) or with a list of
   images (new).
 - It is possible to turn off all the new QML code -- navigation, slideshow,
   QML-based modules -- with a single `-DWITH_QML=OFF` at CMake time.
   This removes QML from Calamares' dependency footprint (but only saves
   200kB in Calamares itself).
 - Tests have been extended and now support a tests/CMakeTests.txt file
   for fine-tuning tests for Python modules.
 - SPDX identifiers are used much more widely and consistently in Calamares.
   (thanks Callum)

## Modules ##
 - The QML based *welcomeq* module is now a viable alternative to the
   *welcome*(widgets based) module. Using QML files means it no longer
   is needed to have pop-up windows for additional information or warnings,
   all loads in the Calamares window itself.  Additional features include the
   option to customize the *About* info and load files like Release Notes
   direct into Calamares, QML files added to the branding directory can be used.
 - The *welcome* and *locale* modules that do GeoIP lookup can now also
   use "fixed" style; this just negates the GeoIP lookup and substitutes a
   constant (fixed) value; useful for testing specific locales.
 - The *keyboard* module no longer uses *ca_eng* keyboards in Canada by
   default, but sticks to the *us* keyboard. #1419


# 3.2.24 (2020-05-11) #

This release contains contributions from (alphabetically by first name):
 - Bill Auger
 - Gaël PORTAY
 - Luna Jernberg
 - Philip Müller

## Core ##
 - There is now a bash-completions script for Calamares; turn on
   the (CMake-time) option INSTALL_COMPLETION to get it. (Thanks Gaël)
 - The *productWallpaper* setting is documented and works. (Thanks Bill)
 - GlobalStorage is available to QML modules as `Global`.
 - The height of the navigation bar in QML can be set within the
   QML code for the navigation; if not set, try something sensible.
 - A regression in the requirements-checker which could block the
   installer from proceeding without telling the user **why** it
   was blocked, has been resolved.

## Modules ##
 - The *bootloader* module can force a UEFI-based machine to boot into
   the newly-installed system. #1394 (Thanks Gaël)
 - *partition* Pop-ups about boot flags use the right flag names. #1192


# 3.2.23 (2020-04-17) #

This release contains contributions from (alphabetically by first name):
 - FLVAL

## Core ##
 - Some strange annotations were added to the *About* dialog text in
   all the translations, like `{1?}`. These have been removed again.

## Modules ##
 - *locale* module had some errors in timezone data, where clicking
   on a city would select a different timezone. Some of these are
   now fixed (thanks FLVAL). #1374
 - *netinstall* supports a wider variety of package naming schemes,
   and is more flexible in loading a `netinstall.yaml` that is copied from
   the example configuration file, *groups* key and all. #1369
 - *users* module logs a full error message from libpwquality if something
   is wrong internally.


# 3.2.22 (2020-04-08) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Camilo Higuita

## Core ##
 - Both the sidebar (on the left) and the navigation buttons (along the
   bottom of the window) can now be configured to use the traditional
   *widgets*, to use *qml*, or *hidden* from view (hiding the navigation
   is not recommended unless you have a pure-QML UI to run inside
   Calamares). The example QML that is compiled into Calamares has
   been improved. To use your own QML, put files `calamares-sidebar.qml`
   or `calamares-navigation.qml` into the branding directory.
 - The sidebar and navigation can now be placed on any side of the
   main window. This is probably only useful for QML-based UIs.
   See `branding.desc` for details.

## Modules ##
 - The *welcomeq* module has been improved with better layout and
   nicer buttons in the example QML form. (Thanks to Anke Boersma)
 - The *keyboardq* and *localeq* modules now provide some QML for
   configuring these parts, although they are still very primitive.
 - *netinstall* has had some minor layout fixes.
 - *unpackfs* has much more detailed progress reporting and no
   longer jumps around strangely in overall progress.
 - *partition* now correctly marks a partition as bootable in BIOS + MBR
   installs. #1175


# 3.2.21 (2020-03-27) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Camilo Higuita
 - Gabriel Craciunescu
 - Gaël PORTAY

## Core ##
 - Python job modules (such as *unpackfs* or *packages*) can now provide
   a `pretty_status_message()` function, like the existing `pretty_name()`
   function, that is used to update the status during install. #1330
 - QML support-modules and objects are now registered into the io.calamares
   namespace. This affects modules using Calamares models inside their
   QML UI (at this point, very few). With this release, the necessary
   `import` for Calamares parts looks like
   > ```import io.calamares.ui 1.0```
   A complete list of objects available from Calamares van be found in the
   documentation in `Qml.h`.
 - The sidebar (which shows overall progress in the installation) is now
   more configurable: the branding key *sidebar* controls it. The sidebar
   can be shown as a widget (default, as it has been), hidden, or use a
   new QML view which is more easily customised.
 - A new `settings.conf` key *quit-at-end* will automatically close
   Calamares (by clicking on the *Done* button) when the end of the
   sequence is reached. If *finished* is the last module in the sequence,
   this will run whatever it is configured for; you can also leave out
   the finished page and Calamares will close after the exec parts.

## Modules ##
 - *packages* now reports more details in the installation progress-bar.
 - *netinstall* module supports an `expanded` key, which will pre-expand
   a group (as if the user had pressed the arrow-button in the tree-view).
   This only affects the UI, and only the **outermost** level of groups.
 - *netinstall* module now supports a special value for *groupsUrl*.
   Setting this to *local* will read the groups directly from the
   configuration file.
 - *netinstall* groups now support a new key `immutable` which prevents
   their check-state from being changed (they are shown, or hidden,
   as usual and can be expanded).
 - Modules that use QML need a new import line. The QML file for the
   module is configured through new keys *qmlSearch* and *qmlFilename*
   (previously those were without the `qml` prefix, which invites name
   collisions). The full module identifier is also used as a filename,
   so that multiple instances of a module can use different QML files.
 - *partition* module has a number of new features and settings for
   type, UUID, and filesystem characteristics. Thanks to Gaël.


# 3.2.20 (2020-02-27) #

This release contains contributions from (alphabetically by first name):
 - Bart Ribbers

## Core ##
 - When logging level is set to 8 (eight), for instance via the `-D8`
   logging flag, or the `-d` debug flag, the *Show debug information*
   button will appear in the progress view. This helps with debugging
   issues where the `-d` flag would be inappropriate.
 - Calamares now starts at logging level 1 (warnings and errors to
   the console) by default. Previously it (wrongly) started at level 8.

## Modules ##
 - The *partition* module now stores which filesystems are in use in
   global storage.
 - The *contextualprocess* module now understands "compound variable
   names", where a dot (.) is used to index into structured data
   stored in global storage. This allows it to use the map stored
   by the partition module (but also other things, like looking into
   the branding information).
 - The *packages* module now understands "apk", the Alpine Linux
   package manager.


# 3.2.19.1 (2020-02-24) #

This is a hotfix release for bugs in the *users* module.
Reported by Philip Mueller and Walter Lapchynski.

## Modules ##
 - The *users* module no longer wrote `/etc/hostname` at all.
 - The *users* module erroneously shows the root password input fields.
 - The *initramfs* module sets a resume-hook even when there is no swap.
 - The partitioning service expects *udevadm* in `/sbin`, but some
   distro's place it elsewhere.
 - The mount service didn't unmount directories properly, leading to
   blocked installations.


# 3.2.19 (2020-02-21) #

This release contains contributions from (alphabetically by first name):
 - Anke Boersma
 - Camilo Higuita
 - Gabriel Craciunescu

## Core ##
 - *Assamese* translation has been completed.
 - Translations are now loaded from more places: instead of **only**
   being compiled in to the Calamares executable, they can now be
   read from the current directory (when Calamares is run in developer
   mode) and from the application data directory.This allows updating the
   translations without requiring a recompile: helpful for translators
   and possibly for distributions with their own translation style.
   See the translators and deployers wiki for details.
 - A new `ViewStep` base class, `QmlViewStep`, has been added that loads
   a configurable QML file and plays it. This is used by the new *notesqml*
   module -- which is in itself a minimal wrapper around the same that
   adds only a translatable module name.

## Modules ##
 - The *machineid* and *users* modules now prefer high-quality random
   data from `/dev/urandom` rather than pseudo-random data. #1254
 - A new *notesqml* module supports loading QML. This can be used for
   "fancy" release notes as a QML application, rather than a webview
   or text widget. Note that this does not replace the slideshow-during-
   installation module.
 - The *users* module now has knobs for setting the hostname and writing
   the `/etc/hosts` file. The new configuration options are documented
   in `users.conf`. #1140
 - Multiple *netinstall* modules can exist side-by-side, and they each
   control the package installation for their part of the package list.
   Previously, a netinstall module would overwrite all of the package
   configuration done by other netinstall modules. Translations can be
   provided in the configuration file, `netinstall.conf`. #1303
 - The *fstab* module no longer "claims" all the swap partitions it finds
   on disk. It only uses swap specified for the current installation.
   This means that "replace" and "alongside" installations will have
   no swap configured in the target system.


# 3.2.18 (2020-01-28) #

This release contains contributions from (alphabetically by first name):
 - Bill Auger

## Core ##
 - *Assamese* translation has been added (still in preliminary state).
 - Timezone support code has migrated into the core of Calamares. This
   means that modules now have easier access to timezone information.
   Translations for timezones have also been enabled, so it is **possible**
   at least to translate the displayed zones in the *locale* module.
 - Branding can now specify whether to (try to) display the Calamares window
   in the middle of the desktop or not. The *windowPlacement* key in
   `branding.desc` specifies *center* or *free* placement.

## Modules ##
 - All modules can now set a new key in `module.desc` called *noconfig*.
   If this key is set to `true` (the default is `false), no configuration
   file is searched-for or loaded, and no warning is printed if the
   configuration is missing. This should tidy up some unnecessary warnings
   on startup. #1302 #1301
 - The *license* module has seen a significant change to its looks.
   Actions are now labeled more clearly, and the URL (or filename)
   for each license is displayed.
 - The *locale* module now supports translations for timezone and
   location names (e.g. "Berlin" is "Berlijn" in Dutch).
 - *Packagechooser* is a little more careful with displaying
   default and empty package names. (thanks to Bill Auger)
 - The *unpackfs* module now carries a larger weight in the overall
   progress of the installation, which should resolve downstream reports
   like "progress stops at 24% for a long time". This is currently
   hard-coded, but will become configurable in a future release. #1176


# 3.2.17.1 (2019-12-02) #

This is a hotfix release for a bug in the grubcfg module.
Reported by Philip Mueller and Erik Dubois.

## Modules ##
 - The *grubcfg* module had a typo in it that made installations fail.


# 3.2.17 (2019-11-28) #

This release contains contributions from (alphabetically by first name):
 - Bill Auger

## Core ##
 - A translation "string freeze" is now enforced by the release scripts.

## Modules ##
 - A new module, *hostinfo*, places information about the host into
   Global Storage. This can support contextualprocess modules that
   need that information.
 - The password-checks in the *users* module are now ordered consistently.
   A new check *nonempty* can be used to explicitly check for a non-empty
   password. This was previously hard-coded. If you have no other
   password-requirements set (e.g. minimum-length) and rely on
   Calamares to filter out empty passwords, add this check.
 - The *grubcfg* module has a new configuration setting *keepDistributor*
   which prevents replacing the `GRUB_DISTRIBUTION` line when writing
   the new configuration. #1201
 - *packagechooser* documentation has been updated.
 - *welcome* module now works better with dark themes.
 - The *license* module could get into a confused state, now fixed. #1271


# 3.2.16 (2019-11-01) #

This release contains contributions from (alphabetically by first name):
 - Bill Auger

## Core ##
 - Some obscure build scenarios which would lead to bogus module-is-
   misconfigured messages on startup have been resolved.

## Modules ##
 - The explanatory messages on the *users* page have moved to tooltips,
   and placeholder text has been added to the fields. #1202
 - The bad-password messages in the *users* page have been improved. #1261
 - Password-checking in the *users* module has been substantially
   changed. A new key *allowWeakPasswords* can be used to introduce
   an additional checkbox to the page, which can then be used to
   switch off strict password checking. (Thanks to Bill Auger)
 - The icons used in password warnings on the *users* page have been
   changed to the colorful status icons (rather than the thin red X).


# 3.2.15 (2019-10-11) #

This release contains contributions from (alphabetically by first name):
 - No other contributors this time around.

## Core ##
 - No changes to core functionality

## Modules ##

 - *displaymanager* module now treats *sysconfig* as a regular entry in the
   *displaymanagers* list, and the *sysconfigSetup* key is used as a
   shorthand to force **only** that entry in the list. #1253
 - *machineid* module has been re-written in C++ and extended with
   a new configuration key to generate urandom pool data. #1252
 - *unpackfs* now supports a special *sourcefs* value of `file`
   for copying single files (optionally with renaming) or directory
   trees to the target system.
 - *unpackfs* now support an *exclude* and *excludeFile* setting for
   excluding particular files or patters from unpacking. #1229


# 3.2.14 (2019-09-30) #

This release contains contributions from (alphabetically by first name):
 - Andrius Štikonas
 - Harald Sitter

## Core ##
 - No changes to core functionality

## Modules ##

 - *locale* module no longer recognizes the legacy GeoIP configuration.
   This has been deprecated since Calamares 3.2.8 and is now removed.
 - *packagechooser* module can now be custom-labeled in the overall
   progress (left-hand column). #1228
 - *displaymanager* module now recognizes KDE Plasma 5.17.
 - *displaymanager* module now can handle Wayland sessions and can detect
   sessions from their .desktop files. #1247 #1248
 - *unpackfs* now has special handling for *sourcefs* setting "file"
   (so you can copy single files or directories that are on the source
   system, directly to the target). #1188 #1181


# 3.2.13 (2019-08-30) #

This release contains contributions from (alphabetically by first name):
 - Arnaud Ferraris
 - Arnaud Rebillout
 - Bill Auger
 - Kevin Kofler

## Core ##

- The Calamares standard coding style -- embodied in `ci/calamaresstyle`
  has had a few updates and has now been consistently applied across
  the core codebase (e.g. libcalamares, libcalamaresui, calamares, but
  not the modules).
- *KCoreAddons* is now a required dependency. This lets us drop a chunk
  of code that was copied from KCoreAddons years ago, and use the
  (maintained!) upstream version instead. It also gives us KMacroExpander
  everywhere, which will simplify code for handling substitutions
  in configuration files.
- *Slideshows* now have a new property *activatedInCalamares* which
  controls the keyboard shortcuts (and can control timers and other
  properties of the slideshow, too).

## Modules ##

- The *packagechooser* module can load data from the config-file,
  from AppData XML files referred by the config-file, and (new) also
  from AppStream caches by referring to an application's AppStream id. #1212
- The *partition* module now understands the units *KB*, *MB*, *GB* which
  are powers-of-ten sizes, alongside the powers-of-two sizes that it already
  used. (thanks to Arnaud)
- The *welcome* module now supports a *Donate* button if *showDonateUrl*
  is set to a non-empty URL. #1197
- The *welcome* module can have URLs for the various buttons configured
  directly in the module configuration (rather than in `branding.desc`).


# 3.2.12 (2019-08-07) #

This release contains contributions from (alphabetically by first name):
 - apt-ghetto
 - Bill Auger
 - embar

## Core ##

 - Preliminary work to allow jobs to have a *weight* assigned to them
   has been added. This will allow the progress bar to better reflect
   progress by the amount of work done rather than purely by the
   number of jobs. (Thanks to Bill Auger)
 - Preliminary work has been added to post the installation log to a
   pastebin for bug reporting. (Thanks to Bill Auger)
 - Support for translated human-readable strings in Calamares
   config files has been added. This is used only in the *packagechooser*
   module (see below) but will expand to those modules that need
   user-visible strings from the configuration file (existing
   solutions need either gettext or Qt support).
 - Esperanto is now available when Qt version 5.12.2 or later is used.

## Modules ##

 - *fstab* A new configuration key *efiMountOptions* has been added, to
   allow setting filesystem options specifically for the EFI partition.
   (Thanks to apt-ghetto)
 - *packagechooser* is a new module for low-density package choices,
   e.g. for selecting a default desktop environment, or adding some
   proprietary drivers, or chosing browsers of office suites. It presents
   **one** collection of items -- at most ten or so, because of the UI --
   and the user can select zero or more of them. The behavior is
   configurable, and package information can be set through the Calamares
   configuration file or by reading AppData files for the packages. #426


# 3.2.11 (2019-07-06) #

This release contains contributions from (alphabetically by first name):
 - No other contributors this time around.

This is a security release with no functional changes (except for
improved security) relative to 3.2.10. The Calamares team would like
to acknowledge the help of the following people in reporting and
understanding the issues (alphabetically by first name):
 - Kevin Kofler
 - Seth Arnold
 - Simon Quigley
 - Thomas Ward
Both CVE's have been resolved.

## Core ##

No core changes.

## Modules ##

 - *initramfs* could create an initramfs with insecure permissions.
   Since the keyfile is included in the initramfs, an attacker could
   read the file from the initramfs. #1190 CVE-2019-13178
 - *luksbootkeyfile* created a key file where a window of opportunity
   existed where the key file could have too-lax file permissions.
   #1191 CVE-2019-13179


# 3.2.10 (2019-06-28) #

This release contains contributions from (alphabetically by first name):
 - No other contributors this time around.

Distributions are **advised** to check the slideshow they use for the
installation step; changes in loading and translation mechanisms may
require changes in the slideshow.

## Core ##

 - With this release, option *WITH_PYTHONQT* changes default to **off**.
   There does not seem to be any serious use of the PythonQt API and
   the UI opportunities it offers, so begin the process of deprecating
   and removing that. Sometime in the future, QML pages will fill the
   gap for easily-prototyped-yet-slick UI elements.
 - A crash when no *finished* page (or rather, no page at all) is
   configured after the last *exec* section of the sequence has been
   solved. The *finished* page can be left out (but then you don't get
   the restart-now functionality). #1168
 - The *slideshow* which is run during installation now has API versions.
   API version 1 (the default) runs as before, where the slideshow is loaded
   when the installation starts. API version 2 loads the slideshow on
   Calamares startup, thus improving responsiveness. Documentation
   in `src/branding/README.md`. #1152
 - The example slideshow now uses API version 2.

## Modules ##

 - *initramfs* has been changed from a Python module to a C++ module.
   Packaging will need to adjust now it installs a .so instead of a .py.
   The module itself functions as before. It does have a new configuration
   option, to change the version passed as to the `-k` option of
   update-initramfs. #1180
 - *partition* Now has its own setting for *requiredStorage*, duplicating
   the same setting in the *welcome* module. This is useful for
   configurations where no *welcome* module is used, but a minimum
   size must be checked anyway. #1169


# 3.2.9 (2019-06-03) #

This release contains contributions from (alphabetically by first name):
 - Kevin Kofler

## Core ##

No user- or deployer-visible changes. Bugfixing as usual, see the
milestone for details.

## Modules ##

 - *branding* now supports os-release variables in the *strings* section,
   which allows re-using (at runtime) information set in /etc/os-release .
   This requires KDE Frameworks 5.58. #1150
 - *branding* allows the use of FreeDesktop.org icon names for the
   *productLogo* and *productIcon* keys. If a file is named there, then
   the file is used, and otherwise the icon is looked up in the current
   theme. #1160
 - *packages* On Arch, with the `pacman` package manager, avoid a hang
   during system update. #1154
 - *welcome* allows a custom image path or icon name to be set for the
   language-selection drop-down (instead of the international standard one).


# 3.2.8 (2019-05-10) #

This is a **source-incompatible** release of Calamares. Include files
have been shuffled around, so third-party C++ modules will need
adjustment to the changed names.

This release contains contributions from (alphabetically by first name):
 - Arnaud Ferraris
 - Kevin Kofler

## Core ##

 - All user-visible texts referring to "MB" and "GB" now use the standard
   "MiB" and "GiB" wording, which matches what we were actually calculating
   with (i.e. 2^20 and 2^30 respectively). #1129
 - The side-pane, which shows the list of steps that will be executed,
   now tries to fit the text (name of each module) into the available space
   by shrinking the font as needed. #1137
 - *libcalamares* (accidentally) linked with Qt's GUI libraries when
   PythonQt was found. This led to the odd situation where the non-GUI
   Calamares library depends on a bunch of GUI libraries.
 - *libcalamares* The `utils/` subdirectory has been hugely refactored,
   with functionality split out into separate files. C++ modules will
   need to have their `#include` names updated. Basically, users of
   `utils/CalamaresUtils.h` will need to include the header file for
   the functionality that is actually used.

## Modules ##

 - *finished* has a new mechanism for configuring the behavior of the
   *restart now* button. The old-style boolean configuration is still
   supported but generates a warning. #1138
 - *locale* module GeoIP configuration has a new preferred format.
   See `locale.conf` for details. The old configuration is still
   supported but will be phased out before 3.3.0 -- in particular,
   support for "legacy" format will be removed, since that was a
   crutch for the disappearance of one GeoIP provider in 2018.
 - *oemid* is a new module for configuring OEM phase-0 (image pre-mastering,
   or pre-deployment) things. It has limited functionality at the moment,
   writing only a single batch-identifier file. #943
 - *welcome* can now do GeoIP lookups as well (but be careful with the
   configuration, since you need a GeoIP that provides country information,
   not just timezones). This will let Calamares select a starting language
   that matches where it is -- which might not be useful at all. #934
 - All Python modules now bail out gracefully on (at least some) bad
   configurations, rather than raising an exception. The pre-release
   scripts now test for exceptions to avoid shipping modules with
   ImportError or SyntaxError results.


# 3.2.7 (2019-04-27) #

This is a **hotfix** release for regressions introduced in the
Python modules. The *localecfg* module was unusable because of
a missing `import`.


# 3.2.6 (2019-04-25) #

This release contains contributions from (alphabetically by first name):
 - Arnaud Ferraris
 - Dominic Hayes (feren)
 - Raul Rodrigo Segura (raurodse)

## Core ##

 * Under-the-hood code cleanups in lots of parts of the core. Calamares now
   builds without warnings when Clang 8 is used.
 * A new *disable-cancel-during-exec* setting provides more fine-grained
   control than *disable-cancel*, which hides the button entirely.
   #1122 (Thanks to Dominic, FerenOS)
 * A branding module can now also cause a stylesheet to be loaded, which
   will be applied to the widgets inside Calamares. #961 (Thanks to Raul)

## Modules ##

 * All of the Python-based modules now have translations enabled. #991
 * *Displaymanager* module has improved support for LightDM configuration.
   #1123 (Thanks to Dominic, FerenOS)
 * *License* module can now display local files inline, and scrolls to
   allow longer lists of licenses and to support long license texts
   displayed inline. #1124 #1125 #1052
 * *Partition* module has additional checks for validity partition layouts.
   #1127 (Thanks to Arnaud)
 * *Welcome* module has improved usability: a standard icon
   alongside the *Language* label, for improved recognition,
   and improved language-list display and sorting. #1107


# 3.2.5 (2019-04-15) #

This release contains contributions from (alphabetically by first name):
 - Arnaud Ferraris
 - Dan Simmons
 - Gabriel Craciunescu

## Core ##

 * View modules (in C++) can now perform their own requirements-checking
   to see if installation makes sense. This expands upon the existing
   requirements checks in the welcome module (RAM, disk space, ..).
   The checks have been made asynchronous, so that responsiveness during
   requirements-checking is improved and the user has better feedback.
 * Support for building an AppImage of Calamares has been added to the
   `ci/` directory. There are use-cases where a containerized build and
   configuration make sense rather than having Calamares installed in the
   host system. (Thanks to the AppImage team, Alexis)
 * OEM mode (phase-1) now correctly refers to Calamares as a "Setup Program"
   rather than an installer. #1100 (Thanks to Arnaud)

## Modules ##

 * *Bootloader* module: a serious bug introduced in 3.2.4 which prevents
   succesful boot after installation on EFI machines, has been repaired.
   (Thanks to Gabriel) #1104
 * *Displaymanager* module: it is no longer a fatal error to not have any
   display-managers. #1095
 * *Partition* module: it is now possible to build without libparted. Since
   KPMCore may not need this library anymore, it is a dependency that will
   be dropped as soon as it is feasible. Add this to the CMake flags:
   `-DCMAKE_DISABLE_FIND_PACKAGE_LIBPARTED=ON`
 * *Partition* module: the location that is selected for the bootloader,
   no longer changes when a new partition is created. #1098
 * Python modules: several modules have had translations added. This is
   usually only visible when the module runs as part of the *exec* step,
   when the module's *pretty name* is displayed. In addition, some error
   messages are now translated.
 * *UnpackFS* module: improved progress reporting and tests. #565


# 3.2.4 (2019-02-12) #

This release contains contributions from (alphabetically by first name):
 - Alf Gaida
 - aliveafter1000
 - Arnaud Ferraris
 - Caio Jordão Carvalho
 - Collabora LTD
 - Gabriel Craciunescu
 - Kevin Kofler
 - Philip Mueller
 - Scott Harvey

## Core ##

 * The Calamares application now recognizes the `-X` or `--xdg-config`
   option, which adds XDG_DATA_DIRS to the places used to find QML
   and branding directories, and XDG_CONFIG_DIRS to the places used
   to find the global settings and module configurations. This allows
   a more fine-grained, and more layered, approach to setting up
   Calamares configurations (in particular, distro's can **add**
   configuration files and give them priority, instead of **forking**
   configuration files).
 * The *branding* file now contains settings that control the size
   and resize behavior of Calamares. See the branding file for
   more documentation. In particular, the setting *windowExpanding*
   can be set to *normal*, *fullscreen* or *noexpand*.
 * The `settings.conf` file can now configure whether the *Cancel* button
   is shown (this isn't a branding thing, because it's quite fundamental
   to the workflow of the installer).

## Modules ##

 * The *partition* module supports RAID devices, but only when Calamares
   is compiled with the newest KPMCore release (3.3.0).
 * The calculation of required space -- including swap -- has been simplified,
   and Calamares no longer reserves 2GiB of space in calculations for internal
   use (this means that it no longer mysteriously drops swap when the disk
   size is close to the required installation size).
 * The name of the type of default filesystem (e.g. ext4 or btrfs) is now handled
   case- and localization-insensitively. This means that *btrfs* is now always
   an acceptable spelling.
 * The currently-selected disk device is remembered between manual partitioning
   and the partitioning-overview pages. (Thanks to Arnaud)
 * *partition* There is new support for partitioning layout presets.
   See `partition.conf` for documentation and details.
 * The *keyboard* module now handles the (bogus) Austrian keymap for
   the system console properly. (Thanks to Kevin)
 * The *preservefiles* module now has a mechanism for setting the permissions
   (and ownership) of preserved files. (Thanks to Scott)
 * New module *fsresizer* can be used to resize filesystems. It is intended
   for use in OEM installs where an image of fixed size is created,
   and then sized to the actual SD card the user has used.
 * The *mount* module now handles missing *extraMounts* and *extraMountsEfi*
   keys gracefully (this is probably a misconfiguration, though, and gives a
   warning).
 * The *packages* module now supports pre- and post-script options
   for all operations, not just during install (keep in mind that
   these run as three separate shells, though).
 * A new *rawfs* module supports straightforward copying of filesystems from
   the installation media to the target stystem. This can be used, for instance,
   for block-level-identical installations.


# 3.2.3 (2019-01-09) #

This release contains contributions from (alphabetically by first name):
 - aliveafter1000

## Core ##

There are no core changes in this release.

## Modules ##

 * *partition* Fixed bug where, during detection of existing systems, the
   existing system partitions may be mounted and then files deleted.
   This is a **limited** version of the patch from aliveafter1000
   that will be in 3.2.4, which tries harder to mount filesystems
   read-only and unmodifiable.
 * *locale* It was possible to set the installer and system language
   (e.g. to German) while the global storage value for *locale*
   remained set to English. Then no localization packages are installed
   (see feature `${LOCALE}` in `packages.conf`). Reported downstream
   in Netrunner.


# 3.2.2 (2018-09-04) #

This release contains contributions from (alphabetically by first name):
 - Andrius Štikonas
 - artoo@cromnix.org
 - Caio Jordão Carvalho
 - Harald Sitter
 - Philip Müller
 - Simon Quigley
 - Walter Lapchynski

## Core ##

 * Example configurations are **no longer installed** by default.
   The default setting for *INSTALL_CONFIG* has changed. Distributions
   are strongly encouraged to write their own configuration files and
   not rely on the example configuration files. Example configurations
   may change unpredictably.
 * It is now possible to express module dependencies through the
   *requiredModules* key in `module.desc`. All of the required modules
   for a given module must occur in the sequence **before** the module
   requiring them. None of the core modules use this facility.
 * The search paths for QML files, branding descriptors and module
   descriptors have been revamped and now self-document in the log.
 * A new `ci/RELEASE.sh` script has been added to streamline releases;
   it is not guaranteed to work anywhere in particular though.

## Modules ##

 * When multiple modules are mutually exclusive, or don't make sense
   to enable concurrectly, a new `USE_<foo>` framework has been added
   to CMake to simplify the selection of modules. This is in addition
   to the existing `SKIP_MODULES` mechanism.
 * Various off-by-one-sector errors in the automatic partitioning
   mode have been corrected. In addition, swap space is calculated
   a little more conservatively.
 * A new module has been added to the core which can configure openrc
   services. To make services configuration consistent:
   - The *services* module has been **renamed** *services-systemd*,
   - The openrc module is named *services-openrc*,
   - At CMake time, it is possible to select all of the services modules,
     or one specific one, by setting the *USE_services* CMake variable.
     By default, all of the modules are built and installed.
 * The systemd-services module can now disable targets and mask both
   targets and services (which will allow you to break the system with
   a bad configuration). The configuration is a little more flexible
   because a service (or target) name can be used on its own with
   sensible defaults.
 * The displaymanager module has been entirely revamped. A long-standing
   bug which ignored the settings for default desktop has been fixed
   (thanks to Walter Lapchynski). Translations have been added to the
   error messages. Each DM now has an implementation class for doing
   all the configuration steps it needs. This groups the code needed for
   a specific DM (and presumably, per-distro) in one place.
   Distro's are **strongly advised** to re-test their DM configuration
   and installation with the revamped code.

# 3.2.1 (2018-06-25) #

This release contains contributions from (alphabetically by first name):
 - Bill Auguer
 - Gabriel Craciunescu
 - Phil Mueller
 - Raul Rodrigo Segura

## Core ##

 * Qt 5.7 is now the minimum required Qt version. Because KPMCore
   (a fairly fundamental dependency) requires Qt 5.7, Calamares
   has followed suit.
 * New testing application `loadmodule` for loading and running a
   single Calamares module.
 * New translations Belarussian and Korean.
 * Jobs can now be *emergency jobs* which run even after a failure.
 * Improved debugging when modules fail to load.
 * Bad configuration files will now cause the user-interface of
   Calamares to display an error message, rather than silently
   ignoring some configuration errors. This will certainly cause
   problems for distributions with sloppy configurations.

## Modules ##

 * New module preservefiles, keeps (log) files around after install;
   this duplicates functionality with the unmount module, but unmount
   is very late, rather limited, and fragile.
 * Interactiveterminal module now disables itself if build requirements
   are not met, rather than blocking the build.
 * Fixes in the timezone map data make the southern hemisphere more
   usable and put Reykjavik in its place.
 * The packages module can now update the target system if explicitly
   told to do so.
 * More paths and executables are configurable in the bootloader module.
 * Distributions are advised to review the `users.conf` setup **again**,
   as some changes in version 3.2.0 caused regressions downstream.
 * Distributions are advised to review their `locale.gen` files
   **again**. Previous changes were too restrictive, matching only
   the specific format Chakra Linux uses. Calamares now preserves
   all the comment-lines in the file and writes enabled locales
   at the end, with a descriptive comment.

# 3.2.0 (2018-05-17) #

This release contains contributions from (alphabetically by first name):
 - Alf Gaida
 - AlmAck
 - Caio Jordão Carvalho
 - Frede H

## Modules ##

 * UI annoyances in the partitioning module were fixed; the
   mount-point selector is now more obvious when no mount-point
   has been chosen, and the mount-point and flags are preserved
   when (re)editing partitions.
 * The handling of `@@ROOT@@` substitution in shellprocesses was
   backwards; this has been fixed (the substitution is made when
   running in the **host**).
 * The user shell is no longer hard-coded to `/bin/bash`,
   but follows the default setting for useradd(8), e.g.
   those set in `/etc/default/useradd`.