[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