On Fri, Aug 6, 2010 at 5:18 PM, Edward K. Ream <[email protected]> wrote: > On my bicycle ride today I had a "road to Damascus" moment: It is > time to kill @root, or at least send to it the attic, there to be > quickly forgotten.
Thanks for all recent comments. I have yet to hear a peep of protest. > Furthermore, imo @root represents truly bad programming practice, a > relic of the 1980's that has no place today. There are at least two, no three, ways in which LP is an anti-pattern. First, sections are toxic in any language containing functions or classes. Leo uses them only to represent lists of imports or lengthy docstrings. Second, LP encourages sections to be defined in multiple places. Third, LP encourages cross-file associations of data. Aside from the association of C function definitions (in .c files) with function prototypes (in .h files), I have never seen a use for this anti-feature. Indeed, it breaks the encapsulation needed for modularity. > Let me be very clear. I think @root is a huge burden on Leo. It more > than doubles the apparent complexity of Leo for newbies, and offers > exactly *nothing* of value to anyone. Yesterdays lightning reorg of Chapter 4 shows that this is an understatement. Free of @root, it was easy to make Chapter 4 far more simple than it has ever been. Looking at the Index, there are almost no entries except for directives, a few simple, standard, tree-related terms and "section" and "section definition". That's *all*. And Chapter 4 now organizes Leo's directives into a few simple groups. > P.S. I am willing to keep leoTangle.py in Leo's core for now, but I > want to "send it to the attic" by removing any mention of it, not only > in the docs, but in the settings, menus and commands as well. Done. For the moment, I am going to leave in tangle and untangle family of commands. I don't think this will cause anyone who *doesn't* use tangle or untangle the slightest inconvenience, and it would be quite useful for anyone who *does* use these commands :-) But I am inclined to remove these commands soon unless I hear howls of protest. Edward -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/leo-editor?hl=en.
