KAS-FORMAT-CHANGELOG(1)

📦
version 5.4 · 3 versions
, in ubuntu stonking

🎀 KAS-FORMAT-CHANGELOG 🎀

okay bestie, so this is kas-format-changelog from the kas suite — it's the project configuration changelog, aka the receipts for every glow-up the config format has ever had. 💅

💖 NAME 💖

kas-format-changelog — project configuration changelog.

✨ DESCRIPTION ✨

The kas project configuration is versioned so that like… the features you're asking for are actually supported by the kas version you're running. no cap. 🫶

📜 Configuration Format Changes

🌱 Version 1 (Alias '0.10')

Added

  • The Include mechanism
  • The Version check

💫 Version 2

Changed

  • Configuration file versions are now integers (glow-up fr fr)

Fixed

  • Including files from repos that are not defined in the current file 🛠️

🧚 Version 3

Added

  • Task key that lets you specify which task to run (bitbake -c)

🍓 Version 4

Added

  • Target key now lets you pass a list of target names

🦋 Version 5

Changed behavior

  • Using multiconfig:* targets now adds the appropriate BBMULTICONFIG entries to the local.conf automatically. periodt.

🌸 Version 6

Added

  • env key now lets you pass custom environment variables to the bitbake build process

👑 Version 7

Added

  • type property on repos, so you can express which version control system to use

⭐ Version 8

Added

  • patches property on repos, so you can 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 get used whenever the appropriate properties aren't defined for a given repository or patch. lowkey so convenient.

🌈 Version 10

Added

  • build_system property to pre-select OE or Isar

🔥 Version 11

Changed behavior

  • String item includes now use repo-relative paths. File-relative is still supported, but 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 made via kas menu in a configuration file. It is only evaluated by that plugin, iykyk.

🎀 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 that case the variables are only exported to the bb env whitelist.

💀 Version 14

Added

  • The keys commit and branch are introduced as a replacement for 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 the 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 🫶

Part of the kas(1) suite.

Author

Daniel Wagner, Jan Kiszka, Claudius Heine

Copyright

Siemens and contributors, 2017-2025

ok that's the whole thing bestie, every single version, no skips, no cap 💖 go forth and configure your projects, you absolute icon 💅✨

this whole page is from kas 5.4, dated Jun 25, 2026 — love that for us 🎀🦋🌸

📦 where this page comes from