Аппаратные и программные

А.3.7 Комментарии 
Время, потраченное на написание комментариев, многократно окупится 
при любых модификациях программы. Однако комментировать все подряд, 
включая самоочевидные действия, как в следующем примере, тоже не стоит:
size = 10; //Присвоить size значение 10 
for( i=0; i{ 
. . . 
} 
Такого рода комментарии только загромождают программу. 
Комментировать следует: 
1. Заголовок файла, описывая содержимое данного файла; 
2. Заголовок функции, поясняя назначение ее аргументов и смысл самой 
функции; 
3. Вводимые переменные и структуры данных; 
4. Основные этапы и особенности реализуемых алгоритмов; 

---

279 
5. Любые места, которые трудны для быстрого понимания, в особенности 
использование различных программных "трюков" и нестандартных 
приемов. 

---

280 
Предметный указатель 
A 
ADC ............................................................. 88 
ADuC812 ................................... 178, 184, 194 
ARINC 429 ................................................ 127 
C 
CAN ............................................. 96, 120, 121 
CFD .................................................... 261, 264 
Code review ............................................... 162 
Controller Area Network ........................... 120 
CPLD ........................................................... 47 
D 
DAC ............................................................. 94 
DFD ............................................ 261, 264, 265 
E 
EEPROM ................... 56, 58, 59, 96, 106, 191 
Embedded system ........................................ 10 
Esterel......................................................... 153 
Ethernet .................................................. 18, 96