О стилистике при оформлении исходников, для начинающих и не только Опции

[sergey sva]

Нужно инвертировать один бит, в переменной, подозреваю что делается очень просто , но что то не соображу как.

#define dataflag (1<<6)
ReturnValue =(ReturnValue ~ dataflag);

[rezident]

#define dataflag (1<<6)

Не в тему, но... есть устоявшееся правило: макросы принято обозначать заглавными буквами, а переменные и функции прописными или сочетанием заглавных и прописных. Так проще воспринимается текст исходника. В приложении русскоязычный перевод Application Note (AN-2000) "Стандарт кодирования на Си", от Micrium, Inc.

Поскольку невольно мое сообщения послужило началом своего рода оффтопка, то выделил подветку из http://electronix.ru/forum/index.php?showtopic=72745 в отдельную тему.

Сообщение отредактировал rezident - Feb 13 2010, 19:58

Прикрепленные файлы

 micrium_an_2000_rus.pdf ( 166.36 килобайт ) Кол-во скачиваний: 1408

 

[x736C]

Полностью тему не прочитал, только выборочно.

1. Пришла в голову банальная мысль, странно, что задумался только сейчас.
Хорошо оформленный текст программы (читаемость, легкость... и т. п.),
кстати как и хорошо оформленный простой текст, приводит к меньшей утомляемости
при работе с ним. Даже если конкретные участки не интересуют, но когда глаз часто
видит кашу, то быстро начинаешь уставать. Не говоря уже про ту часть, непосредственно
отладкой которой занимаешься.

2. Кому-нибудь приходилось выполнять перевод текста программы в MS Word
и в последующем оформленять по ГОСТ?!
Сложилось впечатление (может, у меня что-то криво складывалось), что
и табуляции и пробелы и на моноширинных шрифтах «копипастятся» изначально криво,
требуют доводки. Использовал для этих целей Courier New.
Хотя, быть может, в ворде как раз все правильно, а кривой IDE (AVR Studio).