Как соблюсти ПРАВИЛА ХОРОШЕГО ТОНА при написании программ на Си?, (Как компоновать проект? Что оставлять в xxx.c, а что в xxx.h ?) Опции

[kv_addr]

Написал было объемистое предисловие, но Фаерфокс глюкнул и оно исчезло, поэтому обойдусь без него.

Перешел с ассемблера на Си, создал ряд проектов, работающих, но так и не получил четкого представления о том, как нужно оформлять программу на Си по ПРАВИЛАМ. Может сказалась былая практика программирования на Фортране и Паскале. Наибольшее непонимание у меня вызывает то, что нужно оставлять в xxx.c, а что выносить в xxx.h. Виной тому - ужасная чересполосица в куче разных сторонних проектов, которые довелось разбирать в процессе освоения Си. В одних проектах водораздел один, в других - совсем иной. И даже в атмеловских аппноутах - тоже полный разнобой.

Пользуюсь IAR EWAVR-ом.

Вот пара примеров написания программ, с которыми встречался:
Имеются: основной модуль - xxx.c, хедер к нему - xxx.h, пара модулей - yyy.c, zzz.c и хедеры к ним yyy.h, zzz.h.

Первый вариант организации проекта. В проект подключен основной модуль xxx.c, в котором в самом начале подключен при помощи директив #include необходимый набор стандартных библиотек, хедер xxx.h, а также два дополнительных модуля yyy.c и zzz.c. В самих модулях yyy.c и zzz.c при помощи этих директив подключены yyy.h и zzz.h соответственно. В основном модуле располагается главная программа и набор функций, относящихся непосредственно к ней. В хедере располагаются глобальные определения, описания глобальных переменных и констант, а также прототипы функций основного модуля. В дополнительных модулях располагаются функции модулей, а в хедерах дополнительных модулей располагаются определения, переменные, константы и прототипы, касающиеся этих модулей.


Во втором варианте организации проекта дополнительные модули включены в проект подобно основному. В основном же модуле при помощи #include подключены yyy.h и zzz.h. Также они подключены с помощью этой директивы и в yyy.c и zzz.c соответственно.

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

Встречался также с вариантами написания программ, где, например, описания переменных вынесены в ***.c вместо ***.h.

Имею два конкретных вопроса:

1. КАК нужно подключать в проект модули и хедеры согласно ПРАВИЛ ХОРОШЕГО ТОНА написания программ на языке Си?
2. ЧТО нужно согласно тех же ПРАВИЛ выносить в ***.h, а что оставлять в ***.c?

Четкого, внятного, однозначного ответа я так и не нашел. Хотелось бы узнать мнение уважаемого сообщества.

PS: Конечно, можно компоновать как попало, имея в результате полноценный рабочий код, но вопрос в том, как общепринято ПРАВИЛЬНО это выполнять?

[kv_addr]

TNX. Где-то так и предполагал, что второй вариант будет более правильным и логичным.

Следующий вопрос. Каков общепринятый порядок расположения компонентов хедера? Это на мой взгляд далеко не праздный вопрос. Хотелось бы впредь выработать четкие правила создания логично скомпонованных удобочитаемых и удоборазбираемых программ. Для своего потребления я могу программу наклепать как угодно, все равно она будет работать согласно установленного алгоритма, но для других она будет выглядеть диковато и не удобоваримо.

Я не совсем новичок в программировании, пописывал программы еще когда вычислительные машины были большими и очень большими. Но в основном я - схемотехник, поэтому это было как бы приложением к основной работе. Когда появились "писюки", писать программы на них как-то не приходилось. К микроконтроллерам приступил наперевес с ассемблером. Но когда задачи усложнились, писать на ассемблере стало чрезмерно времязатратным. Поэтому, преодолев некоторые фобии, решил освоиться с Си. Конечно, embedded C весьма специфичен, но вроде уже как освоился и программу "чувствую". Но, понимая, что это немаловажно, также решил упорядочить стиль создания программ, дабы писАть не только под себя. Вот, собственно говоря, это и есть основной причиной моих вопросов.

Кстати, хотя по Си перечитал литературы достаточно, но так и не нашел четких ЛАКОНИЧНО изложенных правил. Может кто подскажет такой источник. Предпочтительно - русскоязычный. Это не значит, что по-английски не читаю, но предпочитаю родной язык, как более удобный в любом случае.