ref manual explanation of do_configure() seems incomplete

"Robert P. J. Day" <[email protected]> Fri, 26 Jun 2026 12:16:07 -0400 (EDT)
Newsgroups org.yoctoproject.lists.docs
Message-ID <[email protected]>
  (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.

rday