пишу документацию на комплекс встроенного программного обеспечения, по стандартам ЕСПД
требуется оформить текст для каждого из компонентов.


Всего 7 компонентов, каждый на своем МК

Язык программирования для всех компонентов С, контроллеры Pic18,dsPic33 и Atmega 128
среды ICC, MPLAB получается целый зоопарк всего.

Столкнулся с тем, что не совсем понятно как оформлять текст программы.

в интернете находил пример оформления текста, причем он был вставлен в вордовский файл

но в том примере сам текст программы был совсем крошечный.

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

не копипасть же все это в один вордовский файл ?

читабельность такого кода будет почти нулевая, форматирование бьется и вообще из за больших отступов
код банально не помещается в формат листа А4


как лучше тогда оформить текст программы по еспд ?

В виде электронного архива на цифровом носителе.
В бумажном виде остается только лист утверждения (ЛУ), упоминание в спецификации на ПО и титульный лист.
Иногда ещё внутренние самопальные документы, типа ИПХ (информационно-поисковая характеристика) - чтобы 100500 миллионов файлов можно было отыскать в шкафу с болванками или zip-драйвами.

а как ссылаться на файл на цифровом носителе ?

скажем есть каталог с проектом, где и МПлабовские файлы проекта и *.h и *.с

даю каталогу имя такое же как и у шифра программного документа "текст программы " ?

сам печатный документ будет выглядеть будет так примерно

ЛУ
Титульный лист
лист с сылкой на цифровой носитель ?

Смежные темы тут обсуждались http://electronix.ru/forum/lofiversion/ind...ml/t101498.html