add documentation for task- and parallel-related macros.
closes #3760, closes #3099