I've decided to solve this by changing it to:

+ * phy_restore_page() must always be called after this, irrespective
+ * of success or failure of this call.

iow, not explaining /why/.

Hi Russell

That is fine by my. A quick read of the code makes it clear why.

     Andrew