better documentation for directive grammar, several fixes, and additional documentation for utils.