Ok the mystery deepens, and I have mixed feelings.
First the good news, as though by magic my N900 recovered, automatically almost by magic. Just a few desktop icons and widgets were gone, but I could simply add them back again.

The bad feeling is I couldn't find the documentation I was looking for.