On Aug 6, 9:05 pm, "Edward K. Ream" <edream...@gmail.com> wrote: > The great collapse in complexity has taken away almost all the blah, > blah, blah of LP (Literate programming). > > Gone are discussions of noweb, CWEB, LaTeX. Leo still supports these > languages, but it does so gracefully, without making a big deal about > it.
let me hasten to add, I am a strong believer in the insights that I assume led to the creation of the original tangle/untangle concepts, that is keeping the docs with the code, now seen in a lighter form in doxygen, javadoc, eudoc and others. the full extent of untangle, as I understand it, just isn't required when the docs are contained in markup in comments. closer to the code, but still a little removed and so they can get out of sync. another common problem, hard to automatically test examples with add hoc extraction of code. you do have to give credit to the idea. but the tools many projects now use are lots more practical and ultimately easier to understand. we know this because there is no significant amount of code using the superior literate methods. maybe I overlooked them? Leo has not even kept the docs with the code itself. which wouldn't necessarily have been an improvement all told. barely using python doc strings except to the extent of having them so as not to mess up auto api generating tools last I cared. docing a moving target is always difficult. so it doesn't hurt to occasionally run off an API list of available methods. even though you know they are out of date as soon as a few plugins run. anyone knows you need more than an API reference for decent docs and too many projects stop there. it doesn't matter where the doc source are located only that they get improved and stay in synch with the code, how ever that is defined. worse than bad docs of course is bad code and anything that makes code more complicated to follow surely is a bug magnet. -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To post to this group, send email to leo-edi...@googlegroups.com. To unsubscribe from this group, send email to leo-editor+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/leo-editor?hl=en.
