add docstrings to the header decls

Requires changing the header! macro; the docstring isn't optional.