реклама на сайте
подробности

 
 
> Систематизация программной документации, попытка стандартизации "стилей программирования"
MrYuran
сообщение Jan 28 2009, 07:12
Сообщение #1


Беспросветный оптимист
******

Группа: Свой
Сообщений: 4 640
Регистрация: 26-12-07
Из: Н.Новгород
Пользователь №: 33 646



Вроде такая тема проскакивала как-то, попробую ещё раз.
Задача такая:
Нужно ввести в конторе какой-то единый образец (или стандарт) написания исходников.
Не так жёстко, что "комментарии только блоками и никак иначе" или определение функции, отформатированное с точностью до пробела, а скорее на структурном, системном уровне, например, как делить проект на модули, что выносить в h-файл, рекомендации по функциональному делению и т.д.

Желательно при этом подходить с т.з. рационального программирования, то есть удобно должно быть не только человеку, читающему код, но и компилятору, оптимизирующему его. На подсознательном уровне вроде всё понятно, но родить документ с ходу не получается.

В конторе 3-4 программиста (я в их числе), у каждого свой неповторимый "стиль".
Попытка что-то обсудить ни к чему не приводит (никто не хочет переделывать свою работу под чужой шаблон)

В общем, решили пока вносить конкретные предложения и рассматривать их по отдельности.

Может, есть у кого подобные рекомендации по оформлению именно структуры кода? (синтаксиса и прочих мелочей пока не касаемся)

Ну и вообще, кидайте что есть (если не секретно или дсп, конечно)

Ещё в связи с плавным перетеканием с IAR на GCC есть мысль писать кросскомпилируемые проекты. То есть в mspgcc есть файл isr_compat.h, с помощью которого унифицируются описания прерываний, думаю что-то подобное написать для остальных нюансов.


--------------------
Программирование делится на системное и бессистемное. ©Моё :)
— а для кого-то БГ — это Bill Gilbert =)
Go to the top of the page
 
+Quote Post



Reply to this topicStart new topic
1 чел. читают эту тему (гостей: 1, скрытых пользователей: 0)
Пользователей: 0

 


RSS Текстовая версия Сейчас: 23rd July 2025 - 16:00
Рейтинг@Mail.ru


Страница сгенерированна за 0.01391 секунд с 7
ELECTRONIX ©2004-2016