X-Git-Url: http://secure.phpeclipse.com

diff --git a/net.sourceforge.phpeclipse.phphelp/src/net/sourceforge/phpdt/httpquery/config/IMemento.java b/net.sourceforge.phpeclipse.phphelp/src/net/sourceforge/phpdt/httpquery/config/IMemento.java
index 2b6a743..43f9ead 100644
--- a/net.sourceforge.phpeclipse.phphelp/src/net/sourceforge/phpdt/httpquery/config/IMemento.java
+++ b/net.sourceforge.phpeclipse.phphelp/src/net/sourceforge/phpdt/httpquery/config/IMemento.java
@@ -4,7 +4,7 @@
  * are made available under the terms of the Common Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/cpl-v10.html
- *
+ �*
  * Contributors:
  *     IBM Corporation - Initial API and implementation
  **********************************************************************/
@@ -14,41 +14,44 @@ import java.util.List;
 
 import org.eclipse.ui.IElementFactory;
 import org.eclipse.ui.IPersistableElement;
+
 /**
- * Interface to a memento used for saving the important state of an object
- * in a form that can be persisted in the file system.
+ * Interface to a memento used for saving the important state of an object in a
+ * form that can be persisted in the file system.
  * <p>
  * Mementos were designed with the following requirements in mind:
  * <ol>
- *  <li>Certain objects need to be saved and restored across platform sessions.
- *    </li>
- *  <li>When an object is restored, an appropriate class for an object might not
- *    be available. It must be possible to skip an object in this case.</li>
- *  <li>When an object is restored, the appropriate class for the object may be
- *    different from the one when the object was originally saved. If so, the
- *    new class should still be able to read the old form of the data.</li>
+ * <li>Certain objects need to be saved and restored across platform sessions.
+ * </li>
+ * <li>When an object is restored, an appropriate class for an object might not
+ * be available. It must be possible to skip an object in this case.</li>
+ * <li>When an object is restored, the appropriate class for the object may be
+ * different from the one when the object was originally saved. If so, the new
+ * class should still be able to read the old form of the data.</li>
  * </ol>
  * </p>
  * <p>
- * Mementos meet these requirements by providing support for storing a
- * mapping of arbitrary string keys to primitive values, and by allowing
- * mementos to have other mementos as children (arranged into a tree).
- * A robust external storage format based on XML is used.
- * </p><p>
- * The key for an attribute may be any alpha numeric value.  However, the
- * value of <code>TAG_ID</code> is reserved for internal use.
- * </p><p>
+ * Mementos meet these requirements by providing support for storing a mapping
+ * of arbitrary string keys to primitive values, and by allowing mementos to
+ * have other mementos as children (arranged into a tree). A robust external
+ * storage format based on XML is used.
+ * </p>
+ * <p>
+ * The key for an attribute may be any alpha numeric value. However, the value
+ * of <code>TAG_ID</code> is reserved for internal use.
+ * </p>
+ * <p>
  * This interface is not intended to be implemented by clients.
  * </p>
- *
+ * 
  * @see IPersistableElement
  * @see IElementFactory
  */
 public interface IMemento {
 	/**
-	 * Special reserved key used to store the memento id
-	 * (value <code>"org.eclipse.ui.id"</code>).
-	 *
+	 * Special reserved key used to store the memento id (value
+	 * <code>"org.eclipse.ui.id"</code>).
+	 * 
 	 * @see #getId
 	 */
 	public static final String TAG_ID = "IMemento.internal.id"; //$NON-NLS-1$
@@ -56,11 +59,12 @@ public interface IMemento {
 	/**
 	 * Creates a new child of this memento with the given fType.
 	 * <p>
-	 * The <code>getChild</code> and <code>getChildren</code> methods
-	 * are used to retrieve children of a given fType.
+	 * The <code>getChild</code> and <code>getChildren</code> methods are
+	 * used to retrieve children of a given fType.
 	 * </p>
-	 *
-	 * @param fType the fType
+	 * 
+	 * @param fType
+	 *            the fType
 	 * @return a new child memento
 	 * @see #getChild
 	 * @see #getChildren
@@ -68,16 +72,18 @@ public interface IMemento {
 	public IMemento createChild(String type);
 
 	/**
-	 * Creates a new child of this memento with the given fType and id.
-	 * The id is stored in the child memento (using a special reserved
-	 * key, <code>TAG_ID</code>) and can be retrieved using <code>getId</code>.
+	 * Creates a new child of this memento with the given fType and id. The id
+	 * is stored in the child memento (using a special reserved key,
+	 * <code>TAG_ID</code>) and can be retrieved using <code>getId</code>.
 	 * <p>
-	 * The <code>getChild</code> and <code>getChildren</code> methods
-	 * are used to retrieve children of a given fType.
+	 * The <code>getChild</code> and <code>getChildren</code> methods are
+	 * used to retrieve children of a given fType.
 	 * </p>
-	 *
-	 * @param fType the fType
-	 * @param id the child id
+	 * 
+	 * @param fType
+	 *            the fType
+	 * @param id
+	 *            the child id
 	 * @return a new child memento with the given fType and id
 	 * @see #getId
 	 */
@@ -85,32 +91,35 @@ public interface IMemento {
 
 	/**
 	 * Returns the first child with the given fType id.
-	 *
-	 * @param fType the fType id
+	 * 
+	 * @param fType
+	 *            the fType id
 	 * @return the first child with the given fType
 	 */
 	public IMemento getChild(String type);
 
 	/**
 	 * Returns all children with the given fType id.
-	 *
-	 * @param fType the fType id
+	 * 
+	 * @param fType
+	 *            the fType id
 	 * @return the list of children with the given fType
 	 */
 	public IMemento[] getChildren(String type);
 
 	/**
 	 * Returns the floating point value of the given key.
-	 *
-	 * @param key the key
-	 * @return the value, or <code>null</code> if the key was not found or was found
-	 *   but was not a floating point number
+	 * 
+	 * @param key
+	 *            the key
+	 * @return the value, or <code>null</code> if the key was not found or was
+	 *         found but was not a floating point number
 	 */
 	public Float getFloat(String key);
 
 	/**
 	 * Returns the id for this memento.
-	 *
+	 * 
 	 * @return the memento id, or <code>null</code> if none
 	 * @see #createChild(java.lang.String,java.lang.String)
 	 */
@@ -118,7 +127,7 @@ public interface IMemento {
 
 	/**
 	 * Returns the name for this memento.
-	 *
+	 * 
 	 * @return the memento name, or <code>null</code> if none
 	 * @see #createChild(java.lang.String,java.lang.String)
 	 */
@@ -126,28 +135,31 @@ public interface IMemento {
 
 	/**
 	 * Returns the integer value of the given key.
-	 *
-	 * @param key the key
-	 * @return the value, or <code>null</code> if the key was not found or was found
-	 *   but was not an integer
+	 * 
+	 * @param key
+	 *            the key
+	 * @return the value, or <code>null</code> if the key was not found or was
+	 *         found but was not an integer
 	 */
 	public Integer getInteger(String key);
 
 	/**
 	 * Returns the string value of the given key.
-	 *
-	 * @param key the key
-	 * @return the value, or <code>null</code> if the key was not found or was found
-	 *  but was not an integer
+	 * 
+	 * @param key
+	 *            the key
+	 * @return the value, or <code>null</code> if the key was not found or was
+	 *         found but was not an integer
 	 */
 	public String getString(String key);
 
 	/**
 	 * Returns the boolean value of the given key.
-	 *
-	 * @param key the key
-	 * @return the value, or <code>null</code> if the key was not found or was found
-	 *  but was not a boolean
+	 * 
+	 * @param key
+	 *            the key
+	 * @return the value, or <code>null</code> if the key was not found or was
+	 *         found but was not a boolean
 	 */
 	public Boolean getBoolean(String key);
 
@@ -155,41 +167,50 @@ public interface IMemento {
 
 	/**
 	 * Sets the value of the given key to the given floating point number.
-	 *
-	 * @param key the key
-	 * @param value the value
+	 * 
+	 * @param key
+	 *            the key
+	 * @param value
+	 *            the value
 	 */
 	public void putFloat(String key, float value);
 
 	/**
 	 * Sets the value of the given key to the given integer.
-	 *
-	 * @param key the key
-	 * @param value the value
+	 * 
+	 * @param key
+	 *            the key
+	 * @param value
+	 *            the value
 	 */
 	public void putInteger(String key, int value);
 
 	/**
 	 * Sets the value of the given key to the given boolean value.
-	 *
-	 * @param key the key
-	 * @param value the value
+	 * 
+	 * @param key
+	 *            the key
+	 * @param value
+	 *            the value
 	 */
 	public void putBoolean(String key, boolean value);
 
 	/**
-	 * Copy the attributes and children from  <code>memento</code>
-	 * to the receiver.
-	 *
-	 * @param memento the IMemento to be copied.
+	 * Copy the attributes and children from <code>memento</code> to the
+	 * receiver.
+	 * 
+	 * @param memento
+	 *            the IMemento to be copied.
 	 */
 	public void putMemento(IMemento memento);
 
 	/**
 	 * Sets the value of the given key to the given string.
-	 *
-	 * @param key the key
-	 * @param value the value
+	 * 
+	 * @param key
+	 *            the key
+	 * @param value
+	 *            the value
 	 */
 	public void putString(String key, String value);
 }
\ No newline at end of file