ИМХО, +1 насчёт комментов. Насчёт WinAVR возможно это наиболее удачный пример кривого использования doxygen. Не знаю и спорить не хочу. Хороших примеров, к глубокому сожалению, не видел.
А насчёт именно нафига глазеть в стандартные либы - дык, действительно, не часто, и не в либы, а в их хидера, но лазить приходится, да ещё и документация, ИМХО, не поспевает за писателями. И вообще после IAR для меня это есть некоторое насилие над собой, которое делаю осознанно - сейчас я могу потратить некоторое время на изучение ещё одного инструмента, который всё-таки бесплатен. Возникает много простых вопросов, ответы на которые часто негде найти. Например, недавно искал, где же устанавливается размер стека - смутно я себе представлял где это может быть, но так и не нашёл. Ах да, чего ж последний раз полез хидеры просматривать - искал (пытался хидеры почитать) функции strncasecmp и memset - о первой недавно Володя Мисячный спрашивал на Телесистемах (кажись синоним какой-то называл), а вторая, IMHO, просто должна быть - дык наступил в комменты от doxygen-а, обломался копаться, ну и сам за пару минут накатал;) Глупо, но зато без психоза;)