On Thu, Oct 27, 2011 at 11:52 PM, daly <d...@axiom-developer.org> wrote:
> > Any means of publication can be the medium for literate programming. > As I rule I prefer Latex but anything will do. > > All you need is a distinguished means of quoting and naming the > chunks. In html this could be as simple as: > <pre id="somename"> > your code > </pre> > and you need a program, often called "tangle", to extract the chunk > tangle mywebpage.html somename >mysomename.file > > Yep. That's all my Rube Goldberg-ish system did. The chunk of machine recognizable code was named as an attribute in a modified <sourcecode> tag. The "weave" just stripped it out so you were left with "typeset ready" Docbook markup. The "tangle" just yanked out the target source code and wrote it to a file in the proper order. > > The hardest part of literate programming is the mindset. > > In order to do literate programming you need to change your focus > from traditional programming to writing for humans and, as a side > effect, writing for the machine. > > <clojure%2bunsubscr...@googlegroups.com><http://groups.google.com/group/clojure?hl=en> > For programmers who are resistant to even commenting code LP must seem nightmarish (at least at first). Not only are you required to provide comments, but those comments have to be a complete, well formatted, human readable, journal article. Also, it takes some time getting one's head wrapped around the fact that the order in which the target language source code appears in the article is not necessarily the order in which the machine needs it for compilation and execution purposes. When LP is practiced consistently it prevents a number of bad habits, and I can't see that those good effects change whether one is using a "top down" or "bottom up" approach to programming. Since you're writing a complete, well formatted, human readable, article on how the code works, you can't just cut-and-paste code into a project without really understanding what the code is doing (well, I guess you can, but that would become obvious while you or another reader were trying to follow the article). -- *Off the Beaten Path in Technology http://otbeatenpath.wordpress.com * -- 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
