The code is the canonical definition of behavior. If you see recipes or docs disagreeing with the code, please show where and how. Note: recipes directly using $D or explicitly calling defer to first boot helper are not in disagreement, they're just not using the documented syntactic sugar.

Alex

On Fri, 17 Dec 2021 at 18:08, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
On Fri, 17 Dec 2021, Robert P. J. Day wrote:

> On Fri, 17 Dec 2021, Alexander Kanavin wrote:
>
> > Hey Robert, may I make a suggestion? Rather than ask someone to
> > explain the implementation of pkg_postinst to you, why don’t you
> > read the implementation and ask questions about specific code where
> > it’s unclear what or why.
>
>   i'm actually doing that, but i'm still not a python expert so i
> struggle with some of the bbclass files trying to follow the logic.

  there's one other complication -- even when i think i follow the
code, i like to look at sample recipes to confirm my understanding,
but that's when i run across stuff like this in
sysvinit-inittab_2.88dsf.bb:

  pkg_postinst:${PN} () {
  # run this on host and on target
  if [ "${SERIAL_CONSOLES_CHECK}" = "" ]; then
       exit 0
  fi

so i have the docs, the code and the sample recipes all seeming to
disagree with each other.

rday