Configuration Format Changes
============================

Version 1 (Alias '0.10')
------------------------

Added
~~~~~

- Include mechanism
- Version check


Version 2
---------

Changed
~~~~~~~

- Configuration file versions are now integers

Fixed
~~~~~

- Including files from repos that are not defined in the current file

Version 3
---------

Added
~~~~~

- ``Task`` key that allows one to specify which task to run (``bitbake -c``)

Version 4
---------

Added
~~~~~

- ``Target`` key now allows one to pass a list of target names

Version 5
---------

Changed behavior
~~~~~~~~~~~~~~~~

- Using ``multiconfig:*`` targets adds appropriate ``BBMULTICONFIG`` entries to
  the ``local.conf`` automatically.

Version 6
---------

Added
~~~~~

- ``env`` key now allows one to pass custom environment variables to the
  bitbake build process.

Version 7
---------

Added
~~~~~

- ``type`` property to ``repos`` to be able to express which version control
  system to use.

Version 8
---------

Added
~~~~~

- ``patches`` property to ``repos`` to be able to apply additional patches to
  the repo.

Version 9
---------

Added
~~~~~

- ``defaults`` key can now be used to set a default value for the repository
  property ``refspec`` and the repository patch property ``repo``. These
  default values will be used if the appropriate properties are not defined
  for a given repository or patch.

Version 10
----------

Added
~~~~~

- ``build_system`` property to pre-select OE or Isar.

Version 11
----------

Changed behavior
~~~~~~~~~~~~~~~~

- String item ``includes`` are now using repo-relative paths. File-relative is
  still supported by issues a deprecation warning.
- bblayers.conf is generated with ``BBPATH`` and ``BBFILES`` preset to common
  defaults. Those can still be overwritten via ``bblayers_conf_headers``.

Added
~~~~~

- ``menu_configuration`` key stores the selections done via ``kas menu`` in a
  configuration file. It is only evaluated by that plugin.

Version 12
----------

Added
~~~~~

- For repositories, ``url`` and ``path`` can now be overridden with a
  null-value to switch between version-controlled repositories and unversioned
  local folders.

Version 13
----------

Added
~~~~~

- Variables used in the ``env`` section can now be assigned *null* as value. In
  this case the variables are only exported to the bb env whitelist.

Version 14
----------

Added
~~~~~

- The keys ``commit`` and ``branch`` are introduced as replacement of
  ``refspec`` in ``repos`` and ``defaults``. ``refspec`` is now deprecated and
  will eventually be removed.
- The ``overrides`` top-level entry can be used to pin floating repo branches.
- ``_source_dir`` top-level entry is auto-generated when using the menu plugin
  and provides the path to the top repo at time of invoking the plugin.
- ``_source_dir_host`` top-level entry is auto-generated by kas-container to
  track the source path outside of the container.

Version 15
----------

Added
~~~~~

- The key ``tag`` is introduced as a complement to ``commit`` and ``branch``
  in ``repos``.

Version 16
----------

Fixed
~~~~~

- The key ``tag`` introduced in v15 was not supported in ``defaults``.
  It's now added.

Version 17
----------

Added
~~~~~

- The key ``artifacts`` is introduced to describe expected build artifacts.

Version 18
----------

Added
~~~~~

The repo keys ``tag`` and ``branch`` can now be set to ``null`` to remove
these properties from the repo. This is needed in case a default value is
set in the ``defaults`` section that should not apply to a repo.

Version 19
----------

Added
~~~~~

Various keys for signature verification of repositories were added:

- top level ``signers`` object to specify keys for signature verification
- in repo definitions, ``signed`` and ``allowed_signers`` are added to
  specify whether a repo is signed and which data to use for verification.

Version 20
----------

Added
~~~~~

- The repo key ``branch`` can now be overridden, including to a null-value.

Version 21
----------

Added
~~~~~

- The repo layers ``prio`` can be used to control the order in which the
  layers are added to the ``BBLAYERS`` bitbake variable.

Version 22
----------

Added
~~~~~

- Switch to nodistro which is the default distro setting in
  openembedded-core.

Version 23
----------

Added
~~~~~

- Extend the allowed values of ``build_system`` by adding ``isar-privileged``
  and ``isar-rootless``.
- The repo key ``url`` can now be overridden.
- The repo key ``commit`` can now be overriden with a null-value in such a way
  that the head of a given branch is used instead of the commit's default
  value.
