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

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.

Antonin