Правильное оформление комментариев, пояснений и документации в исходном коде

Доброго дня!1. Как правильно в исходном коде оформлять комментарии, описания методов и т.п.?например я делаю так в файлах реализации (*.срр):Код:/*! \fn int MyClass::method1(int param1) const \private - тут указываю из какой секции метод (public, private, protected ...) \brief - это краткое описание назначения метода\en - тут на английском назначение\ru - тут на русском назначение \param param1 - тут входные параметры\en - на англ\ru - на русском \return int - тут возвращаемое значение\en - описание возвр знач на англ\ru - описание возвр знач на русск*/int MyClass::method1(int param1) const{тут реализация метода}2. Где почитать про принятые стандарты ТЭГОВ в таких случаях3. Для чего используются тэги?ЗЫ: поделитесь, народ, кто как оформляет исходники: чтобы было красиво, удобно, понятно, и на нескольких языках