RP2040 datasheet Appendix A, 'WC' field type

[arg08]

In the description of the WC field type it correctly says:

The bit is cleared by writing a 1,

But then goes on to say:

using either a normal write or the clear alias. See Section 2.1.2 for more information about the clear alias.

The reference to the clear alias is just plain wrong - you can't write a zero using the clear alias. You could potentially do it using the set alias, but there's no point as the whole reason for having write-1-to-clear registers is that you can just write the value to them without affecting other bits.

Note: this issue being raised as a result of assisting confused users on the forums who had tried and failed to use the clear alias; while I understood the WC fields myself based on prior experience, I have to agree that the documentation is misleading.

Note also that this is RP2040-only: the RP2350 datasheet has the same appendix but with a much more straightforward (and correct!) description.