Boostbook: Support doxygen warning tag.
Thanks to Tim. Refs #5740.
Unfortunately doxygen puts it inside a paragraph. But the generated documentation seems good enough.