What are the differences between @root and @file trees?
@file trees and @root trees represent derived files within an outline. Leo outlines may contain both @root and @file trees. I recommend using @file trees whenever possible. @file trees are much easier to use than @root trees: • @file trees require less markup than @root trees; all sections in @root trees must have names, but @file trees usually contain many unnamed sections. Within @file trees, the @others directive acts like a reference to all unnamed sections. • The user must explicitly tangle and untangle @root trees using the Tangle and Untangle commands. Leo tangles and untangles @file trees automatically, tangling all changed @file trees when writing an outline and untangling all @file trees when reading an outline. @root trees are more flexible than @file trees: • Within @file trees, sections must be defined in descendents of the node that contains the section reference. • Within @root trees a section may be defined anywhere within the @root tree, regardless of where the section
