Re: [docs] [PATCH] ref-manual: add more explanation for ptest-related tasks

On Fri, 26 Jun 2026, Antonin Godard via lists.yoctoproject.org wrote:

> Hi,
>
> On Thu Jun 25, 2026 at 5:42 PM CEST, Robert P. J. Day wrote:
> [...]
> >  ``do_install_ptest_base``
> >  -------------------------
> >
> > -Copies the runtime test suite files from the compilation directory to a
> > -holding area.
> > +As defined in the :ref:`ref-classes-ptest` class, this task contains generic
> > +installation code that will be invoked for all ptest-enabled recipes to
> > +install the associated ptest package::
> > +
> > +   do_install_ptest_base() {
> > +      if [ -f ${UNPACKDIR}/run-ptest ]; then
> > +         install -D ${UNPACKDIR}/run-ptest ${D}${PTEST_PATH}/run-ptest
> > +      fi
> > +
> > +      grep -q install-ptest: Makefile 2>/dev/null && oe_runmake DESTDIR=${D}${PTEST_PATH} install-ptest
> > +
> > +      do_install_ptest
> > +
> > +      ... snip ...
> > +
> > +   }
>
> I am reluctant to include copy-pasted code-snippets from OE-Core,
> they change over time and add maintenance burden. Can you remove it?

  i was thinking the same thing even as i pasted that code in there,
so i will simplify it to show only that do_install_ptest_base() calls
do_install_ptest(), which is not likely to change and is the whole
point of that explanation.

rday