better header doco

fixes #33