[docs] Litprog and Makefiles documentation

[Vitaly Ostanin]

Hello, All!

Ещё на тему описательного программирования.

Допустим, Makefiles/styles из cvs docs вырастут в полноценный
инструмент сборки документов. При сборке авторам захочется
странного:

make HTML_OUT_ENCODING=windows-1251 html-dir

Единственный способ иметь актуальную документацию по параметрам и
целям - держать её рядом с кодом. Ручное обновление документации
после обновления кода/реалий - это общая нерешаемая проблема.

Кроме того, ручное обновление документации затрудняет группировку
параметров и целей, например, "параметры для сборки в HTML",
"печатные выводы".

Предлагаю ещё раз подумать о том, что иногда умножение сущностей
нужно.

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031209/ee3e850d/attachment.bin