Эта запись не противоречит ничему в документации...

первая строка - начало описания макроса @macros[], дажее идет его текст.

вторая приведенная тобой строка: _начало_описания_макроса_ @/macros

При этом потом в коде ты даже можешь вызвать его :)
и ругани не будет, т.к. макрос определен.
Другое дело, что он ничего не делает, т.к. обычно за ним идет какой-нить @macro2[]...
И всего-то делов.

А делают это, как тебе уже сообщили - для улучшения читабельности, т.е. мы приняли для себя: тут заканчивается макрос macros...