Here is the newer official way to add the comments (using preinstalled macro): comment("THIS IS A COMMENT")
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.