add notes about the change.
fix the doc too, reflecting the change introduced by #44 too.