spank: Update spank.h header

Update spank header comments and documentation.

Add #defines for new slurmd and job prolog/epilog contexts, so that
their existence can be tested at compile time.