>> > but, in a nutshell, is literate programming:
>>
>> >
>> > 1. put possibly-out-of-order specially-marked (with an id) code snippets
>> >throughout your doc,
>> > 2. also put an *ordered* listing of all the id's somewhere in your doc,
>> > 3. use tools to find that ordered list of ids, then extract the
>> snippets,
>> >put them in order, and glue them all together so they can be
>> compiled/run?
>>
>> Programs are written in a certain order because the compiler
>> requires it. {snip}
>>
>> If you try to explain various ideas and illustrate them with the
>> REAL code that will be EXECUTED you need to be able to arrange
>> the code in human order, not machine order.
>>
>> ...
>>
>
>Ok. So, if "possibly-out-of-order" (in my message above) means "in human
>order", is my nutshell summary of how literate programming works correct?
As a technology, yes. See
http://daly.axiom-developer.org/clojure.pdf
http://daly.axiom-developer.org/clojure.pamphlet
You'll notice that the Makefile extracts all of Clojure and all of
the tests back to the directory structure required by the compiler.
The code is introduced out of order in the document.
My only hesitation is that it is important not to equate "literate
programming" with a particular detail. I fear that some bright spot
will add "out of order" to org-mode or javadoc and call it
"literate programming", completely missing the point.
Tim Daly
--
--
You received this message because you are subscribed to the Google
Groups "Clojure" group.
To post to this group, send email to clojure@googlegroups.com
Note that posts from new members are moderated - please be patient with your
first post.
To unsubscribe from this group, send email to
clojure+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/clojure?hl=en
---
You received this message because you are subscribed to the Google Groups
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
