Millstone -> IT Mill Toolkit

svn changeset:220/svn branch:toolkit

src/com/itmill/toolkit/event/Action.java

@@ -30,7 +30,7 @@ package com.itmill.toolkit.event;
 
 import com.itmill.toolkit.terminal.*;
 
-/** Implements the MillStone action framework. This class contains
+/** Implements the action framework. This class contains
  * subinterfaces for action handling and listing, and for action handler
  * registrations and unregistration.
  *

src/com/itmill/toolkit/event/EventRouter.java

@@ -33,7 +33,7 @@ import java.util.LinkedList;
 import java.util.Iterator;
 import java.lang.reflect.Method;
 
-/** Event router class implementing the MillStone inheritable event
+/** Event router class implementing the inheritable event
  * listening model. For more information on the event model see the
  * {@link com.itmill.toolkit.event package documentation}.
  *

src/com/itmill/toolkit/event/MethodEventSource.java

@@ -33,7 +33,7 @@ import java.lang.reflect.Method;
 /** <p>Interface for classes supporting registeration of methods as event 
  * receivers.</p>
  * 
- * <p>For more information on the MillStone inheritable event mechanism
+ * <p>For more information on the inheritable event mechanism
  * see the 
  * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
  * 
@@ -48,7 +48,7 @@ public interface MethodEventSource {
 	 * activation method does not have any arguments the event object will
 	 * not be passed to it when it's called.</p>
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -71,7 +71,7 @@ public interface MethodEventSource {
 	 * <code>object</code>, and unless exactly one match is found,
 	 * <code>java.lang.IllegalArgumentException</code> is thrown.</p>
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -90,7 +90,7 @@ public interface MethodEventSource {
 	 * are registered to listen to events of type <code>eventType</code>
 	 * generated by this component.
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -104,7 +104,7 @@ public interface MethodEventSource {
 	 * the given object will no longer be called when the specified events
 	 * are generated by this component.
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -125,7 +125,7 @@ public interface MethodEventSource {
 	 * <code>target</code>, and unless exactly one match is found,
 	 * <code>java.lang.IllegalArgumentException</code> is thrown.</p>
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 

src/com/itmill/toolkit/event/package.html

@@ -7,16 +7,16 @@
 
 <!-- Package summary here -->
 
-<p>Provides classes and interfaces for the MillStone inheritable event
+<p>Provides classes and interfaces for the inheritable event
 model. The model supports inheritable events and a flexible way of
 registering and unregistering event listeners. It's a fundamental building
-block of the MillStone framework, and as it is included in
+block of the IT Mill Toolkit, and as it is included in
 {@link com.itmill.toolkit.ui.AbstractComponent}, all UI components
 automatically support it.</p>
 
 <h2>Package Specification</h2>
 
-<p>The core of the MillStone event model is the inheritable event class
+<p>The core of the event model is the inheritable event class
 hierarchy, and the {@link com.itmill.toolkit.event.EventRouter EventRouter}
 which provide a simple, ubiquitous mechanism to transport events to all
 interested parties.</p>

src/com/itmill/toolkit/package.html

@@ -5,29 +5,31 @@
 
 <body bgcolor="white">
 
-<p>This package is the base of the Millstone library. The base package 
-contains the Application class, the starting point of the Millstone Terminal Independent application.
+<p>This package is the base of the IT Mill Toolkit. The base package 
+contains the Application class, the starting point of any aplication that uses IT Mill Toolkit.
 The sub-packages from this point contain application components and utilities.
 </p>
 
 <h2>Package Specification</h2>
 
-	<b>The Millstone library base is composed of the following packages:</b>
+	<b>IT Mill Toolkit is composed of the following packages:</b>
 	<dl>
 		<dt>com.itmill.toolkit.data</dt>
 		 <dd>A library of interfaces for transparently binding UI components to datasources.</dd>
 		<dt>com.itmill.toolkit.data.util</dt>
 		 <dd>Basic implementations of data-intfaces and utidtties for working with data-bound components.</dd>
-		<dt>com.itmill.toolkit.data.vadtdator</dt>
-		 <dd>Classes providing data-vadtdation for Properties.</dd>
+		<dt>com.itmill.toolkit.data.validator</dt>
+		 <dd>Classes providing data-validation for Properties.</dd>
 		<dt>com.itmill.toolkit.event</dt>
 		 <dd>Interfaces defining how to send and recieve events.</dd>
 		<dt>com.itmill.toolkit.service</dt>
 		 <dd>Classes provding miscelaneous utidtty services.</dd>
 		<dt>com.itmill.toolkit.terminal</dt>
 		 <dd>Classes and interfaces for implementing the terminal specific adapters.</dd>
+		<dt>com.itmill.toolkit.terminal.web</dt>
+		 <dd>Classes that implement support both for AJAX-based and more limited web browsers.</dd>
 		<dt>com.itmill.toolkit.ui</dt>
-		 <dd>The Millstone UI components.</dd>
+		 <dd>UI components.</dd>
 	</dl>
 
 <!-- Put @see and @since tags down here. -->

src/com/itmill/toolkit/service/ApplicationContext.java

@@ -45,7 +45,7 @@ public interface ApplicationContext {
 	
 	/** Returns application context base directory.
 	 * 
-	 * Typically millstone application is deployed in a such way that is 
+	 * Typically an application is deployed in a such way that is 
 	 * has application directory. For web applications this directory is the
 	 * root directory of the web applications. In some cases application 
 	 * might not have application directory (for example web applications 

src/com/itmill/toolkit/service/package.html

@@ -7,8 +7,8 @@
 
 <!-- Package summary here -->
 
-<p>Provides some general service classes used throughout a MillStone
-application.</p>
+<p>Provides some general service classes used throughout a IT Mill Toolkit
+based applications.</p>
 
 <!-- <h2>Package Specification</h2> -->
 

src/com/itmill/toolkit/terminal/PaintTarget.java

@@ -79,7 +79,7 @@ public interface PaintTarget {
 	/** Print element end tag.
 	 *
 	 * If the parent tag is closed before
-	 * every child tag is closed an MillstoneException is raised.
+	 * every child tag is closed an PaintException is raised.
 	 *
 	 * @param tag The name of the end tag
 	 * @exception IOException The writing failed due to input/output error

src/com/itmill/toolkit/terminal/web/AjaxPaintTarget.java

@@ -180,7 +180,7 @@ public class AjaxPaintTarget implements PaintTarget {
      * Print element end tag.
      * 
      * If the parent tag is closed before every child tag is closed an
-     * MillstoneException is raised.
+     * PaintException is raised.
      * 
      * @param tag
      *            The name of the end tag

src/com/itmill/toolkit/terminal/web/ApplicationServlet.java

@@ -389,7 +389,7 @@ public class ApplicationServlet extends HttpServlet implements
 	 * Get ThemeSources from given path. Construct the list of avalable themes
 	 * in path using the following sources: 1. content of THEME_PATH directory
 	 * (if available) 2. The themes listed in THEME_LIST_FILE 3. "themesource"
-	 * application parameter - "org. millstone.webadapter. themesource" system
+	 * application parameter - "ThemeSource" system
 	 * property
 	 * 
 	 * @param THEME_DIRECTORY_PATH

src/com/itmill/toolkit/terminal/web/HttpVariableMap.java

@@ -51,7 +51,7 @@ import java.util.LinkedList;
 import java.util.Iterator;
 
 /**
- * Class implementing the MillStone WebAdapter variable mappings.
+ * Class implementing the variable mappings.
  * 
  * @author IT Mill Ltd.
  * @version @VERSION@

src/com/itmill/toolkit/terminal/web/Theme.java

@@ -48,7 +48,7 @@ import org.xml.sax.Attributes;
 
 /**
  * This class provides an interface to the meta-information regarding a
- * particular webadapter theme. This entails for instanace the inheritance tree
+ * particular theme. This entails for instanace the inheritance tree
  * of the various xsl-template files, the different requirments that the theme
  * imposes on the client browser, etc.
  * <p>
@@ -77,31 +77,6 @@ import org.xml.sax.Attributes;
  * <p>
  * The theme description is XML data, and it can be loaded from file or stream.
  * The default filename is specified by <code>Theme.DESCRIPTIONFILE</code>.
- * Example of theme description file:
- * 
- * <pre>
- *   &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
- * 
- * 	&lt;theme name=&quot;normal&quot;&gt;
- *  
- * 	&lt;extends theme=&quot;simple&quot;/&gt;
- *      
- * 	&lt;description&gt;The normal theme for all browsers&lt;/description&gt;
- *  	&lt;author name=&quot;IT Mill Ltd&quot; email=&quot;millstone@itmill.com&quot; /&gt;
- * 
- * 		&lt;fileset&gt;
- *   		&lt;require&gt;
- *    			&lt;supports javascript=&quot;JavaScript 1.0&quot;/&gt;
- *    		&lt;/require&gt;
- * 
- * 			&lt;file name=&quot;common/error.xsl&quot; /&gt; 
- * 			&lt;file name=&quot;components/button.xsl&quot; /&gt; 
- * 			&lt;file name=&quot;components/select.xsl&quot; /&gt;
- * 			&lt;file name=&quot;components/textfield.xsl&quot; /&gt;
- * 			&lt;file name=&quot;components/table.xsl&quot; /&gt;
- *  		&lt;/fileset&gt;
- *  	&lt;/theme&gt;
- * </pre>
  * 
  * </p>
  * 

src/com/itmill/toolkit/terminal/web/ThemeFunctionLibrary.java

@@ -168,8 +168,6 @@ public class ThemeFunctionLibrary {
 
 	/**
 	 * Generate JavaScript for page that performs client-side combility checks.
-	 * The script includes HTML/JavaScript commands to be included in the body
-	 * of the millstone-form.
 	 */
 	static public boolean probeClient() {
 		return (browser().performClientCheck() && !browser()

src/com/itmill/toolkit/terminal/web/UIDLTransformer.java

@@ -51,7 +51,7 @@ import javax.xml.transform.ErrorListener;
 import javax.xml.transform.SourceLocator;
 import javax.xml.transform.OutputKeys;
 
-/** Class implementing the MillStone WebAdapter UIDLTransformer.
+/** Class implementing the UIDLTransformer.
  *
  * The thansformer should not be created directly; it should be contructed
  * using getTransformer() provided by UIDLTransformerFactory. 

src/com/itmill/toolkit/terminal/web/UIDLTransformerFactory.java

@@ -35,7 +35,7 @@ import java.util.LinkedList;
 import java.util.Map;
 import java.util.Iterator;
 
-/** Class implementing the MillStone WebAdapter UIDLTransformer Factory.
+/** Class implementing the UIDLTransformer Factory.
  * The factory creates and maintains a pool of transformers that are used
  * for transforming UIDL to HTML.
  * 

src/com/itmill/toolkit/terminal/web/WebApplicationContext.java

@@ -46,7 +46,7 @@ import com.itmill.toolkit.service.ApplicationContext;
 import com.itmill.toolkit.ui.Window;
 
 /**
- * Web application context for Millstone applications.
+ * Web application context for the IT Mill Toolkit applications.
  * 
  * @author IT Mill Ltd.
  * @version

src/com/itmill/toolkit/terminal/web/WebPaintTarget.java

@@ -153,7 +153,7 @@ public class WebPaintTarget implements PaintTarget {
 	/** Print element end tag.
 	 *
 	 * If the parent tag is closed before
-	 * every child tag is closed an MillstoneException is raised.
+	 * every child tag is closed a PaintException is raised.
 	 *
 	 * @param tag The name of the end tag
 	 */

src/com/itmill/toolkit/terminal/web/XSLReader.java

@@ -46,7 +46,7 @@ import org.xml.sax.SAXNotSupportedException;
 import org.xml.sax.SAXParseException;
 import org.xml.sax.XMLReader;
 
-/** Class implementing XMLReader for the MillStone WebAdapter UIDLTransformer.
+/** Class implementing XMLReader for the UIDLTransformer.
  *
  * @author IT Mill Ltd.
  * @version @VERSION@
@@ -90,7 +90,7 @@ public class XSLReader implements XMLReader, ContentHandler {
 			xsltProcessor = XSLT_WEBLOGIC;
 		else {
 			throw new RuntimeException(
-				"\nThis version of Millstone Web Adapter "
+				"\nThis version of IT Mill Toolkit "
 					+ " does not support the selected XSLT-processer:\n  "
 					+ transformerName
 					+ "\n"
@@ -421,7 +421,6 @@ public class XSLReader implements XMLReader, ContentHandler {
 		public String getURI(int index) {
 			String uri = original.getURI(index);
 
-			// Map millstone:// namespaces to transformer specific namespaces
 			if (uri != null && uri.startsWith(JAVA_PREFIX)) {
 
 				System.out.print("DEBUG " + uri + " --> ");

src/com/itmill/toolkit/terminal/web/package.html

@@ -8,8 +8,7 @@
 
 <!-- Package summary here -->
 
-<p>Provides the functionality of the MillStone Web Adapter, which adapts the  
-MillStone applications to Web standards. (FIXME: We need a rather more extensive lithany here.)</p>
+<p>This package implement web terminal for both AJAX-capable and more limited web browsers.</p>
 
 <h2>Package Specification</h2>
 

src/com/itmill/toolkit/ui/AbstractComponent.java

@@ -44,7 +44,7 @@ import java.lang.reflect.Method;
 /** An abstract class that defines default implementation for the
  * {@link Component} interface. Basic UI components that are not derived
  * from an external component can inherit this class to easily qualify as a
- * MillStone component. Most components in the MillStone base UI package do
+ * IT Mill Toolkit component. Most components in the toolkit do
  * just that.
  *
  * @author IT Mill Ltd.
@@ -83,7 +83,7 @@ public abstract class AbstractComponent
 	/** The container this component resides in. */
 	private Component parent = null;
 
-	/** The EventRouter used for the MillStone event model. */
+	/** The EventRouter used for the event model. */
 	private EventRouter eventRouter = null;
 
 	/** The internal error message of the component. */
@@ -625,7 +625,7 @@ public abstract class AbstractComponent
 	 * does not have any arguments the event object will not be passed to it
 	 * when it's called.</p>
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -652,7 +652,7 @@ public abstract class AbstractComponent
 	 * <code>object</code>, and unless exactly one match is found,
 	 * <code>java.lang.IllegalArgumentException</code> is thrown.</p>
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -678,7 +678,7 @@ public abstract class AbstractComponent
 	 * are registered to listen to events of type <code>eventType</code>
 	 * generated by this component.
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -695,7 +695,7 @@ public abstract class AbstractComponent
 	 * the given object will no longer be called when the specified events
 	 * are generated by this component.
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 
@@ -719,7 +719,7 @@ public abstract class AbstractComponent
 	 * <code>target</code>, and unless exactly one match is found,
 	 * <code>java.lang.IllegalArgumentException</code> is thrown.</p>
 	 * 
-	 * <p>For more information on the MillStone inheritable event mechanism
+	 * <p>For more information on the inheritable event mechanism
 	 * see the 
 	 * {@link com.itmill.toolkit.event com.itmill.toolkit.event package documentation}.</p>
 	 * 

src/com/itmill/toolkit/ui/AbstractComponentContainer.java

@@ -35,7 +35,7 @@ import java.util.Iterator;
 /** Extension to {@link AbstractComponent} that defines the default
  * implementation for the methods in {@link ComponentContainer}. Basic UI
  * components that need to contain other components inherit this class to
- * easily qualify as a MillStone component container.
+ * easily qualify as a component container.
  * 
  * @author  IT Mill Ltd
  * @version @VERSION@

src/com/itmill/toolkit/ui/Component.java

@@ -40,8 +40,7 @@ import java.util.EventObject;
 import java.util.Locale;
 
 /** The top-level component interface which must be implemented by all
- * MillStone UI components. It contains the methods the MillStone framework
- * needs to handle the components in a user interface.
+ *  UI components that use IT Mill Toolkit
  *
  * @author IT Mill Ltd.
  * @version @VERSION@

src/com/itmill/toolkit/ui/Layout.java

@@ -31,8 +31,7 @@ package com.itmill.toolkit.ui;
 /** Extension to the {@link ComponentContainer} interface which adds the
  * layouting control to the elements in the container. This is
  * required by the various layout components to enable them to place other
- * components in specific locations in the UI. This interface is empty in
- * MillStone 3.0, but will be extended in MillStone 3.1.
+ * components in specific locations in the UI. 
  *
  * @author IT Mill Ltd.
  * @version @VERSION@

src/com/itmill/toolkit/ui/package.html

@@ -8,7 +8,7 @@
 
 <!-- Package summary here -->
 
-<p>Provides interfaces and classes in the the MillStone UI component library.</p>
+<p>Provides interfaces and classes in the IT Mill Toolkit.</p>
 
 <h2>Package Specification</h2>