I use the Javadoc format of documentation in my PHP project, and I like how Sublime highlights the tags in a different color. I managed to find all the official Javadoc tags, but none of those correspond to a general “note” kind of thing, or a warning of some sorts. So I was wondering if there are more tags that Sublime will recognize and highlight, even though they aren’t really Javadoc tags.

I have a need to put some general explanations of why something is done in a completely different way than everywhere else in the project, and none of the existing Javadoc tags cover that sort of intent. I’ve tried to guess stuff like @note @info @warning @bug, but they don’t get highlighted.