svn commit: r1371913 - /creadur/whisker/trunk/src/site/fml/faq.fml

[rd...@apache.org]

Author: rdonkin
Date: Sat Aug 11 10:48:52 2012
New Revision: 1371913

URL: http://svn.apache.org/viewvc?rev=1371913&view=rev
Log:
Answer some questions about directories posed by the latest example

Modified:
    creadur/whisker/trunk/src/site/fml/faq.fml

Modified: creadur/whisker/trunk/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/creadur/whisker/trunk/src/site/fml/faq.fml?rev=1371913&r1=1371912&r2=1371913&view=diff
==============================================================================
--- creadur/whisker/trunk/src/site/fml/faq.fml (original)
+++ creadur/whisker/trunk/src/site/fml/faq.fml Sat Aug 11 10:48:52 2012
@@ -310,8 +310,54 @@ There are currently no known plugins. If
             <p>
             As in &lt;within dir='.'&gt;
             </p>
+            <p>
+Read how directories are modeled <a href='#how-dir-model'>here</a>           
+            </p>            
+        </answer>
+    </faq>
+    <faq id='how-dir-model'>
+        <question>How are directories modeled?</question>
+        <answer>
+            <p>
+ Directories are modeled by a flat list of <code>within</code>
+ elements.
+            </p>
+            <p>
+Read why <a href='#why-dir-model'>here</a>           
+            </p>
+            <p>
+See how the root directory is modelled <a href='#how-root-dir'>here</a>
+            </p>
+        </answer>
+    </faq>
+    <faq id='why-dir-model'>
+        <question>Why are directories modeled as a flat list?</question>
+        <answer>
+            <p>
+            Simplicity
+            </p>
+            <p>
+ Within a file system, the containment relationship between
+ directories typically forms a natural tree. Modern file systems 
+ typically allow cyclic links only with special links (for example,
+  <code>symbolic links</code> in 
+  <a href='http://dbpedia.org/resource/Unix-like'>*nix</a>).
+  Including these links would allow directory containment
+  to become a graph. XML element containment forms a natural
+  tree structure, but representing a graph in XML requires 
+  links to break this structure.
+  This would introduce more complexity 
+  and more ways to make mistakes but little gain. 
+            </p>
+            <p>
+Read how directories are modeled <a href='#how-dir-model'>here</a>           
+            </p>
+            <p>
+See how the root directory is modelled <a href='#how-root-dir'>here</a>
+            </p>
         </answer>
     </faq>
+    
     <faq id='how-contents'>
         <question>How are the contents of a distribution represented?</question>
         <answer>