Here is the newer official way to add the comments (using preinstalled macro):
comment("THIS IS A COMMENT")
http://docs.splunk.com/Documentation/Splunk/7.2.1/Search/Addcommentstosearches
Would you mind editing this into a question and a separate answer? Then please accept the answer so future readers will find it.