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

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

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

Спасибо. прочитаю.

Не советую ВСЁ принимать близко к сердцу.

Да уж, хватает совершенно безаппеляционных и ничем не оправданных утверждений.

Ну, внутрикорпоративным правилам и положено быть безапелляционными.

Но соглашусь, с моей точки зрения, приведенный документ содержит один из худших возможных вариантов "стандарта кодирования".

Лучше иметь правила, чем не иметь.
А что больше всего не нравится?

В довесок читаем MISRA rules, дуреем и радостно находим после у себя остатки извилин.

В порядке упоминания:
- типа пишите в стиле "моя твоя понимай", дабы любой чукча мог понять? Но я не чукча
- не используйте goto - где-то кто-то что-то слышал, что "настоящие программисты" так делать не должны.
- не используйте табуляцию - чистое ламерство
- никогда не пишите комментарии над кодом - ну просто бред. Комментировать каждую строчку, тем более побитую в соответствии
чукотским восприятием - это глупость, комментируется именно блок операторов и в комментарии описывается что глобально делается а
не что такое 2 + 2.
- используйте #if 0 для комментирования блоков - трюкачи, блин, а нормальные редакторы и компиляторы не судьба пользовать.

Дальше по нарастающей


Да, это самая известная по дебильности попытка заставить обезьяну программировать без ошибок и использовать жалкие подобия компиляторов.

Оформление блоков типа:

И пробелы вместо табуляции тоже бесят.

Далее:
- !defined(X)
- Дикая бредятина про многострочные комментарии
- Лишние пробелы везде и всюду

Кстати, поскольку устоявшиеся стили code folding в соответствующих редакторах (codeblocks например) показывают свернутые блоки в виде

считаю полезным помещать комментарии к блоку сразу за скобкой.
И еще никогда не понимал смысла вот такого форматирования (это Astyle):

Нафига такая фигня фигачецца?

А я терзаниях по поводу табуляции.
После ассемблера и Паскаля использование табуляции считал обязательным.
В ИАРе четыре года назад сделал табуляцию два пробела - на ноутбуке приходилось работать, иначе ничего не видно.
Но теперь приходится иногда глянуть текст чем-нибудь по f3/f4, получается ерунда.
То ли переходить на пробелы, то ли на tab= 4 (что пишут), теперь с шириной экрана 17' уже некритично.

ИМХО, tab 4 - самый правильный способ.

Для 'C' - 4. Для ASM - 8



Ничего не понял. Начинал работать на каком-нибудь 14" CRT и никаких проблем от 4 не имел.

Именно по этой причине некоторые программисты (считающие TAB "самым правильным способом") так привязаны к конкретным (самым правильным) редакторам Правда потом их цитаты исходников на форуме приходится править (чтобы многочисленными TABами страницу в браузере не распирало), но ведь это работа модератора, а не барина пользователя, не так ли?

Покажите мне редактор, который не умеет устанавливать размер табуляции. Только пыль сдуть предварительно не забудьте.


Мне почему-то казалось, что код обычно пишется не для выкладывания на форум.