[comments] clarify DeclarationExp usage

Add explanation that it can be used in contexts where D grammar
normally prohibits declarations if you create it in AST manually.
Merge pull request #3389 from Dicebot/decl-exp-docs

[comments] clarify DeclarationExp usage