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

 
 
 
Reply to this topicStart new topic
> Систематизация программной документации, попытка стандартизации "стилей программирования"
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
dissector
сообщение Jan 29 2009, 17:22
Сообщение #2


Частый гость
**

Группа: Участник
Сообщений: 158
Регистрация: 6-04-05
Пользователь №: 3 911



Дайте прогерам почитать статью Автоматное программирование для начинающих. Все детально, на пальцах, с примером. Есть и ссылки на гуру в части автоматного программирования. Забудете обо всем на свете, включая проблемы с кодами smile.gif
Go to the top of the page
 
+Quote Post
altlogic
сообщение May 14 2009, 11:57
Сообщение #3


Местный
***

Группа: Свой
Сообщений: 222
Регистрация: 2-12-06
Из: г. Хабаровск
Пользователь №: 23 035



MrYuran: вы разработали документ? Я иду дальше, готовлю документ по оформлению программ на языке Си, где будет указано даже то, где надо ставить скобочки. Недавно обратил внимание, что сам придерживаюсь вполне определённого стиля оформления кода, который по мнению некоторых профессиональных программистов не очень читаем. Задумался...


--------------------
С уважением, Вячеслав
Go to the top of the page
 
+Quote Post
des00
сообщение May 15 2009, 06:47
Сообщение #4


Вечный ламер
******

Группа: Модераторы
Сообщений: 7 248
Регистрация: 18-03-05
Из: Томск
Пользователь №: 3 453



Цитата(MrYuran @ Jan 28 2009, 02:12) *
Ну и вообще, кидайте что есть (если не секретно или дсп, конечно)



Макконел «Совершенный код. Практическое руководство по разработке программного обеспечения»

Соглашения по оформлению кода команды RSDN


--------------------
Go to the top of the page
 
+Quote Post
_Pasha
сообщение May 15 2009, 14:27
Сообщение #5


;
******

Группа: Участник
Сообщений: 5 646
Регистрация: 1-08-07
Пользователь №: 29 509



Цитата(altlogic @ May 14 2009, 14:57) *
Я иду дальше, готовлю документ по оформлению программ на языке Си, где будет указано даже то, где надо ставить скобочки.

А использовать утилиту Astyle религия не позволяет? Дайте кодовым форматтерам делать свое дело, вместо того, чтобы издавать бессмысленные законы
Go to the top of the page
 
+Quote Post

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

 


RSS Текстовая версия Сейчас: 25th July 2025 - 08:41
Рейтинг@Mail.ru


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