KAS-FORMAT-CHANGELOG(1)

NAME
kas-format-changelog - project configuration changelog

DESCRIPTION

The kas project configuration is versioned to ensure that the requested features are supported by the current kas version.

  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.

SEE ALSO

kas-project-config(1)

KAS

Part of the kas(1) suite.

Author
Daniel Wagner, Jan Kiszka, Claudius Heine

Copyright
Siemens and contributors, 2017-2025