[Aldor-l] Literate programming

Ralf Hemmecke ralf at hemmecke.de
Wed Aug 20 15:10:07 EDT 2008


> I am currently on vacation in austria, so I will have limited time to
> code, but I am working on backtrace.cc (from librona), making it a 
> literate programming file.

What kind of vacation is that? ;-)

> I hope some of you can comment on my interpretation of literate
> programming.

Maybe you could send some instructions on how to find your code.

> By the way, as I see it, API documentation should be in POD and code 
> documentation in LaTeX along with the code (as literate programs).
> POD is excellent for API documentation. Am I seeing this right?

What would be wrong in also doing the API documentation in LaTeX? But I 
guess, more important than the format is the content at the moment. One 
can always reformat. So I would suggest do it in a way you are most 
comfortable with.

Ralf



More information about the Aldor-l mailing list