Re: [docs] ref manual explanation of do_configure() seems incomplete

On Mon, 29 Jun 2026, Antonin Godard via lists.yoctoproject.org wrote:

> Hi,
>
> On Fri Jun 26, 2026 at 6:16 PM CEST, Robert P. J. Day wrote:
> >
> >   (currently poring over ref manual "tasks" section, will ask about
> > whatever seems confusing.)
> >
> > here:
> >
> > https://docs.yoctoproject.org/ref-manual/tasks.html#do-configure
> >
> > one reads:
> >
> > "The default behavior of this task is to run oe_runmake clean if a
> > makefile (Makefile, makefile, or GNUmakefile) is found and CLEANBROKEN
> > is not set to “1”. If no such file is found or the CLEANBROKEN
> > variable is set to “1”, the do_configure task does nothing."
> >
> >   if you check the task definition:
> >
> > https://git.openembedded.org/openembedded-core/tree/meta/classes-global/base.bbclass#n379
> >
> > it seems that even if that test fails, there might still be some
> > subsequent processing, so stating that it will do "nothing" seems
> > potentially misleading.
>
> What would you suggest instead of "does nothing"? It seems
> irrelevant to go in details about the next steps taken in the task.

  i don't know but, based on the task definition, it certainly appears
that *something* might happen. or just leave it the way it is.

rday