bialix_ (15.01.2008 13:00, просмотров: 286) ответил Gamma SPb на я вас уже попросил привести пример НЕуродского применения doxygen. Тогда вы удачно куда-то слились. Еще раз можно попросить?
свои рабочие исходники я показывать не желаю. для души я программирую на питоне, так что это будет непоказательно. в открытом доступе -- где-то видел хорошие примеры, но опять же искать надо. Поэтому опишу два своих главных правила. http://onembedding.com/articles/scons_doxy/
Я использую систему со служебным символом @ вместо \ -- получается гораздо читаемее. Плюс коменты выделяются по левому краю сплошной полосой звездочек.
/** Краткое описание функции */
void func(void)
/** Краткое описание с описанием аргументов
* @param foo наш хитрый аргумент
*/
void func (int foo)
{
...
}
/**
* Длинное описание функции
* в несколько строк
* далее могут идтить аргументы, описание
* возвращаемых значений и т.п.
*/
int func (...)
{
}
Вот в таком ключе. Звездочки слева позволяют моску эффективно парсить код -- как любыть выражаться наш Евгений.
В качестве совсем короткого примера -- см. на моем сайте. Примеры аж 2005 года. Кое-что у меня стало лучше, но суть осталась та же.