bialix (27.06.2007 14:49, просмотров: 1) ответил Evgeny_CD на Есть чудный документ - Linux Kernel Coding Style ->. Я уже который год его перечитываю, и нахожу в нем что-то новое для себя. И постепенно с ним соглашаюсь. Vit прав - не нужно загружать мозги
ИМХО, поток сознания поплыл куда-то не туда. и далеко так не туда. Vit показал один из заголовочных файлов. В нем куча всякой муры, которая нужна, чтобы красиво сделать потом доку для сайта.
Вы же говорите про исходники, т.е. про код. Без минимальной документации к функциям, как-то:
* для чего функция и что делает
* какие аргументы принимает
* что возвращает
Мне лично читать исходники без комментов к функциям -- неинтересно и слишком трудозатратно. Потому что в каждую функцию надо вникать. ОНО МНЕ НАДО? Все равно глаза будут что-то отфильтровывать. Вы какой-то придуманный идеал себе лелеете.
WinAVR -- здесь для меня не показатель, потому что я видел более удачное использование doxygen, и свой стиль оформления тоже считаю удачным и не напрягающим мозги. Плюс к этому WinAVR -- это компилер, предоставляющий стандартные либы. Вы часто перечитываете исходники стандартных либ? Чаще чем свои собственные исходники?
)
)