Document mutable accessors.

And organize the interface docs a bit more formally.