|
Вроде такая тема проскакивала как-то, попробую ещё раз.
Задача такая:
Нужно ввести в конторе какой-то единый образец (или стандарт) написания исходников.
Не так жёстко, что "комментарии только блоками и никак иначе" или определение функции, отформатированное с точностью до пробела, а скорее на структурном, системном уровне, например, как делить проект на модули, что выносить в h-файл, рекомендации по функциональному делению и т.д.
Желательно при этом подходить с т.з. рационального программирования, то есть удобно должно быть не только человеку, читающему код, но и компилятору, оптимизирующему его. На подсознательном уровне вроде всё понятно, но родить документ с ходу не получается.
В конторе 3-4 программиста (я в их числе), у каждого свой неповторимый "стиль".
Попытка что-то обсудить ни к чему не приводит (никто не хочет переделывать свою работу под чужой шаблон)
В общем, решили пока вносить конкретные предложения и рассматривать их по отдельности.
Может, есть у кого подобные рекомендации по оформлению именно структуры кода? (синтаксиса и прочих мелочей пока не касаемся)
Ну и вообще, кидайте что есть (если не секретно или дсп, конечно)
Ещё в связи с плавным перетеканием с IAR на GCC есть мысль писать кросскомпилируемые проекты. То есть в mspgcc есть файл isr_compat.h, с помощью которого унифицируются описания прерываний, думаю что-то подобное написать для остальных нюансов.
--------------------
Программирование делится на системное и бессистемное. ©Моё :)
— а для кого-то БГ — это Bill Gilbert =)
|
Систематизация программной документации, попытка стандартизации "стилей программирования"
Jan 28 2009, 07:12
