exported hooks, doc & typo.