STM32H7 Flash operation - WBNE flag use is unclear in RM0433

[GreenGuy]

The information in RM0433 regarding the use of the WBNE flag with respect to flag operation is unclear. In DocID029587 Rev 3, page 148/3178 it states:

"WBNE1 is reset by hardware each time the write buffer is emptied. This happens when one

of the following event occurs:

– the write buffer is full

..."

The words, "This happens...", I assume refers to the words, "reset by hardware each time the write buffer is emptied". But then it goes on to state "This happens when", the "write buffer is full."

Does anyone else find this very confusing?

Then the document goes on to say, "This bit cannot be forced to ‘0’. To reset it, clear the write buffer by performing any of the

above listed actions."

I assume the actions are the bullet listed items preceded by " - ".

But those looks more like states, except for, "the user forces the write operation".

Again, is this not confusing?

[Tesla DeLorean]

When the documentation is confusing or counter-intuitive I go to the code, and if that still doesn't help I prod the silicon.

IC guys tend to lean toward the least convoluted/complex as possible whereas the SW guys layer it as thick as they can.