[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Orgmode] Re: Literate Programming with Org mode

From: Eric H. Neilsen, Jr.
Subject: Re: [Orgmode] Re: Literate Programming with Org mode
Date: Wed, 29 Jul 2009 17:16:10 -0500
User-agent: Thunderbird (X11/20090625)


sam kleinman wrote:

Here's a literate programing example:
I talked with a statistician, programer and human rights violation
researcher, who wrote (with his team) reports of statistical studies
of data regarding possible genocide incidents. He wrote the LaTeX
documents which, within the text of the document, all values and
analysis' were called in and generated when LaTeX ran, so that as data
was collected, and the report was recompiled the analysis was
completed with the most up-to-date version of the data, and that the
production of the text was isolated from the collection of data, and
from the analysis of those figures.
The stack itself, was comprised of Sweave
<http://www.stat.umn.edu/~charlie/Sweave/> R for stats processing,
make, and a little bit of python for glue. I think.
This is how it is often used in R (or S), and is compatible with the original idea, which is a little broader. The idea is to write a full software application by first writing a document about its design and implementation (in whatever organization is clearest for humans), but at a high enough level of detail that *all* code in *all* source files in the final application gets included somewhere in code snippets within the documentation. To compile your program, you run a program to "tangle" your text into C files, makefiles, or whatever is appropriate, and then compile that (with no additional editing).

See http://www.literateprogramming.com/

Every time I have tried this, I have given up in frustration at the tools. I have put together some org code to do it, and have used it successfully for some small projects, but I am still pulling my hair out on being able to properly contribute it to org, and it would need to be reworked in light of other developments anyway. org-babel now has includes literate programming in it as well, but I have not yet experimented with it (but am very interested in trying).


Eric H. Neilsen, Jr.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]