[bootlin/training-materials] be197b: yocto: slides: rename LICENSE_FLAGS_WHITELIST -> L...

Thu Aug 18 10:19:10 CEST 2022

  Branch: refs/heads/master
  Home:   https://github.com/bootlin/training-materials
  Commit: be197b8b55158fddc7664a6b6859777b09f3abea
      https://github.com/bootlin/training-materials/commit/be197b8b55158fddc7664a6b6859777b09f3abea
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-17 (Wed, 17 Aug 2022)

  Changed paths:
    M slides/yocto-licensing/yocto-licensing.tex

  Log Message:
  -----------
  yocto: slides: rename LICENSE_FLAGS_WHITELIST -> LICENSE_FLAGS_ACCEPTED

As renamed upstream.

Also checked all the renamed variables listed in
scripts/contrib/convert-variable-renames.py, none appears in our slides
except for LICENSE_FLAGS_WHITELIST.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: 7d987399ef7e2a637c7f5b27dde78b0ecde57a3e
      https://github.com/bootlin/training-materials/commit/7d987399ef7e2a637c7f5b27dde78b0ecde57a3e
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-17 (Wed, 17 Aug 2022)

  Changed paths:
    M mk/yocto-stm32.mk
    M mk/yocto.mk
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: move varflags slide before varflags are used (almost)

Explaining PACKAGECONFIG is quite hard, not only because it is an advanced
topic, but also because it is heavily based on varflags, which are
introduced later on.

Move the "Variable flags" subsection before PACKAGECONFIG (still within the
"Writing recipes - going further" section).

Also move yocto-licensing after yocto-recipe-extra as it uses varflags too,
and there is no cross-dependency between those two sections.

According to my search, there is no other use of varflags in the slides
except for SRC_URI[*sum], but let's keep it as is: SRC_URI is such a basic
variable that it's not possible to move it late in the slides, and moving
varflags earlier than that would anticipate a slightly complex topic for no
reason.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: 00be8299f93384b74acaa4a951d938fb6f6ac549
      https://github.com/bootlin/training-materials/commit/00be8299f93384b74acaa4a951d938fb6f6ac549
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-17 (Wed, 17 Aug 2022)

  Changed paths:
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: improve varflags examples

Add a SRC_URI[md5sum] example for two reasons: make it clear that varflags
apply also to variables (not only tasks) and as a hint for the speaker to
mention "we've already seen a varflag usage".

Change the "nostamp" example to something where "nostamp" makes sense, such
as do_menuconfig.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: c7a85773299b508d4b2e4834f634444dfd71f9e0
      https://github.com/bootlin/training-materials/commit/c7a85773299b508d4b2e4834f634444dfd71f9e0
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-17 (Wed, 17 Aug 2022)

  Changed paths:
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: mention inline python alongside python tasks

This is used in the slides, and it can be rather obscure to newcomers.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: cfad4b780d9d15d4c645d6968a949906aba9a750
      https://github.com/bootlin/training-materials/commit/cfad4b780d9d15d4c645d6968a949906aba9a750
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-17 (Wed, 17 Aug 2022)

  Changed paths:
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: move "Using Python code in metadata" earlier

This topic is used in a preceding subsection ("Package features"), thus
move it earlier.

The subsection sequence was:

 - Variable flags
 - Packages features
 - Conditional features
 - Using Python code in metadata  <--
 - Root filesystem creation
 - Splitting packages

and becomes:

 - Using Python code in metadata  <--
 - Variable flags
 - Packages features
 - Conditional features
 - Root filesystem creation
 - Splitting packages

with the goal of having all syntax-related topics first but still keeping
"Variable flags" just before "Packages features" where it is used.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: 40d6ee0420b041a3d12723b190e266a0e9d027ef
      https://github.com/bootlin/training-materials/commit/40d6ee0420b041a3d12723b190e266a0e9d027ef
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-18 (Thu, 18 Aug 2022)

  Changed paths:
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: consolidate the datastore variable 'd' in the dedicated slide

Mentioning it in advance can be confusing and it is not useful as there is
an entire slide for it immediately after.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: 58a496d8ca210fa5e2f76336087c1c4730984a51
      https://github.com/bootlin/training-materials/commit/58a496d8ca210fa5e2f76336087c1c4730984a51
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-18 (Thu, 18 Aug 2022)

  Changed paths:
    M slides/buildroot-yocto-introduction/buildsystem-principle.dia

  Log Message:
  -----------
  yocto/buildroot: slides: buildsystem-principle.dia: sort output products

Move the toolchain at the top of the output product list, as it is
logically the first one that is built.

Also tweak two slightly unaligned arrows to point to the box centre.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: 07b3b738b64b9324a41bac0794d96b2ee8200cae
      https://github.com/bootlin/training-materials/commit/07b3b738b64b9324a41bac0794d96b2ee8200cae
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-18 (Thu, 18 Aug 2022)

  Changed paths:
    M slides/yocto-overview/yocto-overview.tex
    A slides/yocto-overview/yocto-principle.dia

  Log Message:
  -----------
  yocto: slides: add overview picture showing binary packages

Showing early how yocto builds binary packages and not directly a rootfs is
expacted to remove a lot of confusion in trainees. Do it with a modified
copy of the buildsystem-principle.dia picture.

Also add a link to the big and complex picture in the Yocto
documentation. The idea is that the trainer can click to open this picture
and keep it open during the training to describe the blocks one by one when
the corresponding topic is described in the training.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: b41446a53e1ed9bc8a8b718ba5eec899e4c30629
      https://github.com/bootlin/training-materials/commit/b41446a53e1ed9bc8a8b718ba5eec899e4c30629
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-18 (Thu, 18 Aug 2022)

  Changed paths:
    A slides/yocto-recipe-extra/splitting-packages.dia
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: rework "Splitting packages"

Rework the "Splitting packages" section to be more rational:

 * Add an introductory picture
 * Move the slide about FILES:${PN} from section "Root filesystem
   Generation" to here
 * Introduce things gradually: first the 3 steps (install, package,
   package_write_rpm), then PACKAGES, then FILES, then the example
 * Assorted tweaks

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

  Commit: 958a430fc1e1c4412e0ac3640b3bef999417b6b3
      https://github.com/bootlin/training-materials/commit/958a430fc1e1c4412e0ac3640b3bef999417b6b3
  Author: Luca Ceresoli <luca.ceresoli at bootlin.com>
  Date:   2022-08-18 (Thu, 18 Aug 2022)

  Changed paths:
    M slides/yocto-recipe-extra/yocto-recipe-extra.tex

  Log Message:
  -----------
  yocto: slides: update description of rootfs generation

The rootfs_deb_do_rootfs code does not exist in oe-core since a long
time. Remove it and replace it with a more descriptive line in the previous
slide.

Also add the first step for rootfs generation: creating an empty directory.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>

Compare: https://github.com/bootlin/training-materials/compare/ff361263d081...958a430fc1e1