krysalis-impus/src/documentation/content/xdocs index.xml,1.2,1.3

Update of /cvsroot/metamorphosis/krysalis-impus/src/documentation/content/xdocs
In directory sc8-pr-cvs1:/tmp/cvs-serv22197a/src/documentation/content/xdocs

Modified Files:
	index.xml 
Log Message:
Added the why not xml section.


Index: index.xml
===================================================================
RCS file: /cvsroot/metamorphosis/krysalis-impus/src/documentation/content/xdocs/index.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** index.xml	21 Mar 2003 04:09:38 -0000	1.2
--- index.xml	24 Mar 2003 11:54:12 -0000	1.3
***************
*** 75,78 ****
--- 75,120 ----
              </p>
          </section>
+         <section>
+             <title>Why not XML?</title>
+             <p>
+                 I was asked why not use XML for this project.  You would get the parser
+                 for free and you would have a familiar syntax.  There are a few
+                 reasons why I chose to go with the current solution:
+             </p>
+             <ul>
+                 <li>XML is verbose.  I wanted something simple and lightweight that
+                     clearly hilighted the data and structure. Consider these two alternatives:
+                 </li>
+             </ul>
+             <source>
+             (myArray=[ (position=(x=1 y=2) size=(width=10 height=20)
+                 (position=(x=2 y=2) size=(width=2 height=11)) ])
+             </source>
+             <source>
+             &lt;myArray&gt;
+                 &lt;value&gt;
+                     &lt;position x="1" y="2"/&gt;
+                     &lt;size width="10" height="20"/&gt;
+                 &lt;/value&gt;
+                 &lt;value&gt;
+                     &lt;position x="2" y="2"/&gt;
+                     &lt;size width="2" height="11"/&gt;
+                 &lt;/value&gt;
+             &lt;/myArray&gt;
+             </source>
+             <ul>
+                 <li>I wanted to learn ANLTR.  The users of this package may
+                 not care too much but this reason but it's a reason regardless.</li>
+             </ul>
+             <ul>
+                 <li>I don't subscribe to everything necessarily having to be
+                 in XML.  Some things just shouldn't be done as XML.</li>
+             </ul>
+             <ul>
+                 <li>XML uses a lot of quotes.  These are awkward to embed in strings in Java.
+                 Impus uses quotes too but not as much.  Future versions will allow
+                 you use a single quote for strings.</li>
+             </ul>
+         </section>
      </body>
  </document>




-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf