Added sorting to elddoc lists and updated site pages for better english.

src/site/apt/download.apt

@@ -29,7 +29,7 @@ Downloading
    <dependency>
    		<groupId>org.x4o</groupId>
    		<artifactId>x4o-core</artifactId>
-   		<version>0.8-SNAPSHOT</version>
+   		<version>0.8.5-SNAPSHOT</version>
    </dependency>
 +--
 
@@ -38,8 +38,9 @@ Downloading
 * Download binary release.
   
   Sorry we still have not done any binany releases.
+  When completed it should be on the {{{http://download.savannah.gnu.org/releases/x4o/}release}} page.
   
 * Downloading source code
   
-  Sorry we still have no source access.  
+  see {{{./source-repository.html}repository}} page.
   

src/site/apt/examples/load-modules.apt

@@ -23,11 +23,12 @@
 
 Load Modules
 
-  The default language loader of x4o load all 'META-INF/<language>/<language>-modules.xml' in the classpath.
+  The default language loader of x4o loads all 'META-INF/<language>/<language>-modules.xml' resources found in the classpath.
-  So every extension library has its own modules definition file. 
   
+  So every extension library has its own modules definition file. 
   All options are allowed in multiple forms and order.
-  For xsd file see x4o-core classpath 'META-INF/language/modules-1.0.xsd'.
+  
+  The xsd file can be found in the x4o-core project classpath 'META-INF/language/modules-1.0.xsd'.
   
 +--
 <?xml version="1.0" encoding="UTF-8"?>
@@ -50,3 +51,16 @@ Load Modules
 	</language>
 </modules>
 +--
+  
+ * eld-resource
+  
+  The eld-resource tag loads the eld resource relative from the modules xml resource.
+  
+ * module-loader
+  
+  The module-loader lets you define module extensions and namespaces in code.
+  
+ * sibling-loader
+  
+  The sibling-loader lets you load other languages into the language used.
+

src/site/apt/examples/sample-swixml.apt

@@ -275,7 +275,79 @@ public class BorderConverter extends AbstractStringObjectConverter {
 }
 +--
 
+* XML to parse
+
++--
+<frame name="mainframe" size="800,600" title="SWIXML-X4O" plaf="com.sun.java.swing.plaf.windows.WindowsLookAndFeel" defaultCloseOperation="3">
+	<menubar name="menubar">
+		<menu name="filemenu" text="File">
+			<menuitem name="mi_new" text="New" icon="icons/new.gif" mnemonic="VK_N" accelerator="control N" Action="newAction"/>
+			<menuitem name="mi_open" text="Open" icon="icons/open.gif" mnemonic="VK_O" Accelerator="control O" ActionCommand="open"/>
+			<menuitem name="mi_save" text="Save" icon="icons/save.gif" mnemonic="VK_S" ActionCommand="save"/>
+			<menu name="propmenu" text="Properties" icon="icons/new.gif" >
+				<menuitem name="mi_prop_edit" text="Edit" icon="icons/new.gif"/>
+				<menuitem name="mi_prop_clear" text="Clear" icon="icons/new.gif"/>	
+			</menu>
+			<separator/>
+			<menuitem name="mi_exit" text="Exit" icon="icons/exit.gif" mnemonic="VK_X" Accelerator="control X" ActionCommand="exit" Action="exitAction"/>
+		</menu>
+		<menu text="Help">
+			<menuitem name="mi_about" text="About" enabled="true" icon="icons/info.gif" Accelerator="alt A" Action="aboutAction" />
+		</menu>
+	</menubar>
+	<desktoppane>
+		<internalframe Title="Flow Layout (right aligned)" Bounds="10,10,150,150" Layout="FlowLayout(FlowLayout.RIGHT)" Visible="true" Resizable="true">
+			<button>1</button>
+			<button>2</button>
+			<button>3</button>
+			<button>4</button>
+		</internalframe>
+		<internalframe Title="Grid Layout" Bounds="200,10,170,170" Layout="GridLayout(4,3)" Visible="true" Resizable="true">
+			<button text="1"/><button text="2"/><button text="3"/>
+			<button text="4"/><button text="5"/><button text="6"/>
+			<button text="7"/><button text="8"/><button text="9"/>
+			<button text="*"/><button text="0"/><button text="#"/>
+		</internalframe>
+		<internalframe Title="Border Layout" Bounds="390,10,150,150" Layout="borderlayout" Visible="true" Resizable="true">
+			<button constraints="BorderLayout.NORTH" text="1"/>
+			<button constraints="BorderLayout.EAST"  text="2"/>
+			<button constraints="BorderLayout.SOUTH" text="3"/>
+			<button constraints="BorderLayout.WEST"  text="4"/>
+		</internalframe>
+		<internalframe Title="Tree Window" Bounds="10,170,350,360" Layout="borderlayout" Visible="true" Resizable="true">
+			<panel layout="borderlayout" constraints="BorderLayout.CENTER">
+				<splitpane oneTouchExpandable="true" dividerLocation="200">
+					<splitpane oneTouchExpandable="true" dividerLocation="140" orientation="VERTICAL">
+						<scrollPane background="blue" >
+							<tree name="tree"/>
+						</scrollPane>
+						<panel layout="borderlayout">
+							<panel constraints="BorderLayout.NORTH">
+								<button name="btn_copy" ToolTipText="JPanel" enabled="true" BorderPainted="false" FocusPainted="false" icon="icons/copy.gif" size="24,24"/>
+								<button name="btn_paste" ToolTipText="JButton" enabled="true" BorderPainted="false" FocusPainted="false" icon="icons/paste.gif" size="24,24"/>
+								<button name="btn_cut" ToolTipText="JLabel" enabled="true" icon="icons/cut.gif" BorderPainted="false" FocusPainted="false" size="24,24"/>
+							</panel>
+							<scrollPane constraints="BorderLayout.CENTER">
+								<table name="table"/>
+							</scrollPane>
+						</panel>
+					</splitpane>
+					<panel name="preview" border="LoweredBevelBorder">
+						<textarea name="ta" text="Tree Status Log....." background="red"/>
+					</panel>
+				</splitpane>
+			</panel>
+			<panel constraints="BorderLayout.SOUTH">
+				<label text="Status:"/>
+				<textfield text="OK"/>
+			</panel>
+		</internalframe>
+	</desktoppane>
+</frame>
++--
+
+
 * Source
 
-  This example is found in the x4o-core source package in the test path.
+  This example is found in the x4o-core source package in the test java and resouces path.
   

src/site/apt/examples/start-language.apt

@@ -55,6 +55,12 @@ public class FooBarParserSupport implements X4OParserSupport {
 		FooBarParser parser = new FooBarParser();
 		return parser.loadElementLanguageSupport();
 	}
+	
+	public TestBeanRoot getRoot() {
+		// Simple way to return single root object.
+		// note; element tree is cleared after parsing only root element is there. 
+		return (TestBeanRoot)getDriver().getElementLanguage().getRootElement().getElementObject();
+	}
 }
 +--
 
@@ -128,3 +134,23 @@ public class FooBarParserSupport implements X4OParserSupport {
 
   Now you can startup the parser to see it work.
   
+* Create xml to parse
+  
++--
+<?xml version="1.0" encoding="UTF-8"?>
+<r:root
+	xmlns:l="http://foobar.test.x4o.org/xml/ns/foobar-lang"
+	xmlns:r="http://foobar.test.x4o.org/xml/ns/foobar-root""
+	>
+	<l:testBean value="testing xml"/>
+</r:root>
++--
+  
+* Parse the xml
+  
++--
+FooBarParser p = new FooBarParser();
+p.parseFile("foobar/example.xml");
+TestBeanRoot root = p.getRoot();
++--
+

src/site/apt/examples/validation.apt

@@ -23,25 +23,24 @@
 
 Validation
 
-  Schema validation is just new feature and work in progress to have it support all different xml language formats.
+  Schema validation is just an new feature and work in progress.
-  With x4o there are currently two options howto validate your documents, it depends if the language is extended.
+  There are still option being added so it can support all different xml languages.
   
-* Validating parser
+  With x4o there are currently two options to validate your documents, it depends if the language is extended at runtime or not.
-
+  The actual grammer validation is done by the java jaxp parser.
-+--
-	TestParser parser = new TestParser();
-	parser.setProperty(X4OLanguagePropertyKeys.VALIDATION_INPUT, true);
-	parser.parse(...);
-+--
 
 * Generate static languages
 
-  Store the generated xsd files in the (resource)classpath of project in META-INF/<language>/<ns-schemaResource>. 
+  When the xml language is not dynamicly extended at runtime all the schemas can be generated in the build process
+  and be included in the jar file.
+  
+  These generated xsd files are stored in the (resource)classpath of project in META-INF/foobar/foobar-1.0.xsd.
+  Then the validating parser will find the schema resources while loading the namespace contexts.
+   
   These schemas can be created or updates while package project or update manually by build script of profile.
+  For example see the profile in the pom.xml of the x4o-plugin-ant-schema module.
   
-  For example see the profile in the pom.xml of the x4o-plugin-ant-schema.
+  Use validating parser
-  
-  * Validating parser
   
 +--
 TestParser parser = new TestParser();
@@ -66,7 +65,7 @@ Validation
 <eldXsdWriter destdir="/tmp" supportclass="org.foo.bar.TestParserSupport"/>
 +--
   
-  * Validating parser
+  Use validating parser
   
 +--
 TestParser parser = new TestParser();
@@ -75,4 +74,6 @@ Validation
 parser.parse(...);
 +--
   
+  Note; In future there will be an automatic schema generation option for dynamicly defined langauges so that parser can
+  be set always on full validating.
 

src/site/apt/features.apt

@@ -25,7 +25,7 @@ X4O Features
 
   * Advanced XML to Object tree parsing.
   
-  * Easy create an extensible xml language.
+  * Easy to create an extensible xml language.
   
   * Dynamic module system for language loading.
 
@@ -55,5 +55,5 @@ X4O Features
   
   * Basic XSD Schema generation from ELD.
   
-  
+  * Generate javadoc like documenation of the langauge.
   

src/site/apt/index.apt

@@ -28,7 +28,7 @@ Overview
   This is done by defining your own element language definitions in one or more xml files, which in 
   turn are also done by x4o recursively and so it can be extended.
   
-  The extension modules are dynamically loaded from the classpath to define new namespaces.
+  The extension modules are dynamically loaded from the classpath to define the namespaces.
   Besides the elements in the namespace, modules also define the object parent child relation
   binding interfaces which results in an object tree. 
   
@@ -49,19 +49,10 @@ Overview
 
 * Examples
 
-  There are two examples written out;
+  There are two examples; {{{./examples/sample-swixml.html}SwiXml}} and {{{./examples/sample-jr4o.html}JR4O}}
   
-  {{{./examples/sample-swixml.html}Sample SwiXml}}
+  But at its core the main function of x4o is to translates the xml elements into beans and binds them to an tree. 
-  
+  See this example of the FooBean class;
-  {{{./examples/sample-jr4o.html}Sample JR4O}}
-
-  But to put it simple, x4o translates the xml elements into beans;
-
-+--
-<my:fooBean test="hello wold"/>
-+--
-
-  Creates an instance and sets the name property of this bean;
   
 +--
 class FooBean {
@@ -75,3 +66,11 @@ class FooBean {
 }
 +--
   
+  When using this in xml is looks like;
+  
++--
+<my:fooBean test="hello wold"/>
++--
+  
+  So x4o has created an instance and sets the xml attributes as properties of this bean.
+  

src/site/apt/usage.apt

@@ -23,6 +23,8 @@
 
 Usage
   
+  X4O had multiple modules the one which is most used is x4o-core which implements the full x4o framework.
+  
 * X4O maven modules
   
   * x4o = project base.
@@ -54,7 +56,7 @@ Usage
 
   Note: currently x4o is not in main maven repro, so build and install local yourself.
 
-* Setup ant task
+* Setup build task
 
   Append one or both of the x4o eld ant tasks;
 
@@ -71,26 +73,26 @@ Usage
   </dependency>
 +--
 
-  Use in ant and set the supportclass on the language you want todo the task for.
+  Use in ant and set the supportclass from the language you want to run the task for.
   
 +--
 <taskdef name="eldDocWriter" classname="org.x4o.plugin.ant.eld.doc.EldDocWriterTask"/>
 <taskdef name="eldXsdWriter" classname="org.x4o.plugin.ant.eld.xsd.EldXsdWriterTask"/>
 
-	<target name="test-cel-schema-full" depends="init">
+<target name="build-cel-schema" depends="init">
-		<mkdir dir="${test.dir}/cel-full"/>
+	<mkdir dir="${test.dir}/cel-schema"/>
 	<eldXsdWriter
-			destdir="${test.dir}/cel-full"
+		destdir="${test.dir}/cel-schema"
 		supportclass="org.x4o.xml.eld.EldParserSupportCore"
 		/>
 </target>
-	<target name="test-elddoc-cel" depends="init">
+<target name="build-cel-elddoc" depends="init">
-		<mkdir dir="${test.dir}/cel"/>
+	<mkdir dir="${test.dir}/cel-elddoc"/>
 	<eldDocWriter
-			destdir="${test.dir}/cel"
+		destdir="${test.dir}/cel-elddoc"
 		supportclass="org.x4o.xml.eld.EldParserSupportCore"
 		/>
 </target>
-	
 +--
 
+

x4o-elddoc/src/main/java/org/x4o/xml/eld/doc/EldDocHtmlWriter.java

@@ -31,6 +31,8 @@ import java.lang.reflect.InvocationTargetException;
 import java.lang.reflect.Method;
 import java.util.ArrayList;
 import java.util.Collection;
+import java.util.Collections;
+import java.util.Comparator;
 import java.util.Date;
 import java.util.List;
 
@@ -186,7 +188,9 @@ public class EldDocHtmlWriter {
 			printHeader(pw,"Overview Modules ("+title+")","");
 			printPageIndexTitle(pw,title,null,null);
 			printTableStart(pw,"Modules");
-			for (ElementLanguageModule mod:context.getElementLanguageModules()) {
+			List<ElementLanguageModule> mods = context.getElementLanguageModules();
+			Collections.sort(mods,new ElementLanguageModuleComparator());
+			for (ElementLanguageModule mod:mods) {
 				printTableRowOverview(pw,toSafeUri(mod.getId())+"/index.html",mod.getId(),mod.getName());
 			}
 			printTableEnd(pw);
@@ -205,7 +209,9 @@ public class EldDocHtmlWriter {
 			String title = context.getLanguageConfiguration().getLanguage()+" "+context.getLanguageConfiguration().getLanguageVersion()+" ELD";
 			printHeader(pw,"Overview Namespace("+title+")",pathPrefix);
 			printPageIndexTitle(pw,title,null,null);
-			for (ElementLanguageModule mod:context.getElementLanguageModules()) {
+			List<ElementLanguageModule> mods = context.getElementLanguageModules();
+			Collections.sort(mods,new ElementLanguageModuleComparator());
+			for (ElementLanguageModule mod:mods) {
 				printNamespaces(pw,mod.getElementNamespaceContexts(),pathPrefix,mod);
 			}
 			printBottom(pw,pathPrefix);
@@ -240,6 +246,7 @@ public class EldDocHtmlWriter {
 					}
 				}
 			}
+			Collections.sort(rootNodes,new TreeNodeComparator());
 			for (TreeNode rootNode:rootNodes) {
 				walkTree(rootNode,pw,pathPrefix);
 			}
@@ -326,7 +333,7 @@ public class EldDocHtmlWriter {
 				}
 			}
 		}
-		
+		Collections.sort(result,new TreeNodeComparator());
 		return result;
 	}
 	
@@ -384,7 +391,7 @@ public class EldDocHtmlWriter {
 				}
 			}
 		}
-		
+		Collections.sort(result,new TreeNodeComparator());
 		return result;
 	}
 	
@@ -421,7 +428,9 @@ public class EldDocHtmlWriter {
 			printPageTitle(pw,"Namespace",ns.getUri(),ns.getDescription());
 			
 			printTableStart(pw,"Element Summary");
-			for (ElementClass ec:ns.getElementClasses()) {
+			List<ElementClass> ecs = ns.getElementClasses();
+			Collections.sort(ecs,new ElementClassComparator());
+			for (ElementClass ec:ecs) {
 				printTableRowOverview(pw,toSafeUri(ec.getTag())+"/index.html",ec.getTag(),ec.getDescription());
 			}
 			printTableEnd(pw);
@@ -980,4 +989,22 @@ public class EldDocHtmlWriter {
 		pw.print("\t\t<td class=\"NavBarCell1\"><a href=\""+pathPrefix+"namespace-overview.html\">Namespaces</a>&nbsp;</td>\n");
 		pw.print("\t\t<td class=\"NavBarCell1\"><a href=\""+pathPrefix+"tree-overview.html\">Tree</a>&nbsp;</td>\n");
 	}
+	
+	class ElementLanguageModuleComparator implements Comparator<ElementLanguageModule> {
+		public int compare(ElementLanguageModule o1,ElementLanguageModule o2) {
+			return o1.getId().compareTo(o2.getId());
+		}
+	}
+	
+	class TreeNodeComparator implements Comparator<TreeNode> {
+		public int compare(TreeNode o1,TreeNode o2) {
+			return o1.elementClass.getTag().compareTo(o2.elementClass.getTag());
+		}
+	}
+	
+	class ElementClassComparator implements Comparator<ElementClass> {
+		public int compare(ElementClass o1,ElementClass o2) {
+			return o1.getTag().compareTo(o2.getTag());
+		}
+	}
 }

x4o-meta/src/main/resources/META-INF/meta/meta-lang.eld

@@ -32,6 +32,8 @@
 	providerName="x4o.org"
 	id="meta-lang"
 	>
+	<eld:description>The x4o meta language lets you do special xml tricks.</eld:description>
+	
 	<eld:attributeHandler id="global-el-id"	attributeName="el.id" bean.class="org.x4o.xml.meta.lang.ELIDAttributeHandler">
 		<eld:description>Lets you bind object into the expression language context.</eld:description>
 	</eld:attributeHandler>
@@ -39,8 +41,11 @@
 		uri="http://meta.x4o.org/xml/ns/meta-lang"
 		schemaUri="http://meta.x4o.org/xml/ns/meta-lang-1.0.xsd"
 		schemaResource="meta-lang-1.0.xsd"
+		schemaPrefix="meta-lang"
 		name="X4O Meta Language"
+		id="meta-lang"
 		>
+		<eld:description>Some special xml tags in this namespace.</eld:description>
 			
 		<eld:element tag="bean"				elementClass="org.x4o.xml.eld.lang.BeanElement">
 			<eld:description>