refs #4 more documented