Foren / National / Russian / Вопросы и пожелания к движку

С документацией действительно беда.

Это не комментарии а условные операторы. Означает следующее:

Если переменная $location равна 'Forums' (верный признак того, что мы на форуме) - то вставить то что между <!-- IF {PHP.location}  =='Forums' --> и <!-- ENDIF -->

Почитайте это:

http://www.cotonti.com/docs/ext/themes/xtemplate_introduction

http://www.cotonti.com/docs/ext/themes/cotemplate_advanced

Многое станет понятным. Правда дока по на английском. Но скинсейкерам нужно знать.