[docs] Re: Literate programming for Makefiles

[Oleg A. Paraschenko]

  Привет!

On Tue, 4 Nov 2003 20:24:54 +0300
"Oleg A. Paraschenko" <olpa на xmlhack.ru> wrote:

...

> > Ну так пишите
> > простые Makefile - но их описания должны быть в любом случае, и
> > они будут вставлены в документацию.
> 
>   Во, ещё придумал:
> 
> * Я люблю делать завершённые вещи. #-Комментарии внутри make -- завершённые вещи. LP-комментарии -- нет. Их надо "компилировать". А если при этом make-файл ещё невалиден и ничего не собирается?
> 
> * успех php, perl и других basic'ов в том, что как написал -- так сразу и проверил. В варианте с LP надо вначале "компилировать".

  И ещё:

* Раз мы пишем текст для документации внутри самих make-файлов, то мы должны писать на русском языке. А тогда есть повод порассуждать какую кодировку использовать -- обычную, cp1251, iso-8859-5 или utf-8. Тоже не есть хорошо.


...

-- 
Oleg