Форумы / National / Russian / [Локализация] Формат лэнг-файла

То, что 2-й вариант, в принципе следует отсюда: Coding Guide.

Comments and documentation
...
In Cotonti we use PHPDoc style comments to get good API documentation out of the box without spending much time on it.