+2004-04-20 Michael Koch <konqueror@gmx.de>
+
+ * javax/swing/JLayeredPane.java,
+ javax/swing/plaf/BorderUIResource.java,
+ javax/swing/plaf/ComponentUI.java,
+ javax/swing/undo/CompoundEdit.java,
+ javax/swing/undo/StateEdit.java:
+ Fixed HTML tags in javadocs all over.
+
2004-04-20 Michael Koch <konqueror@gmx.de>
* javax/print/attribute/EnumSyntax.java
* <dd>An offset into a layer's "logical drawing order". Layer position 0
* is drawn last. Layer position -1 is a synonym for the first layer
* position (the logical "bottom").</dd>
+ * </dl>
*
* <p><b>Note:</b> the layer numbering order is the <em>reverse</em> of the
* component indexing and position order</p>
*
* @author Graydon Hoare <graydon@redhat.com>
*/
-
public class JLayeredPane extends JComponent implements Accessible
{
-
public static String LAYER_PROPERTY = "LAYER_PROPERTY";
public static Integer FRAME_CONTENT_LAYER = new Integer (-30000);
*
* <p><img src="../border/doc-files/BevelBorder-1.png"
* width="500" height="150"
- * alt="[An illustration showing raised and lowered BevelBorders]" />
+ * alt="[An illustration showing raised and lowered BevelBorders]" /></p>
*
* @param bevelType the desired appearance of the border. The value
* must be either {@link javax.swing.border.BevelBorder#RAISED}
*
* <p><img src="../border/doc-files/BevelBorder-2.png" width="500"
* height="150" alt="[An illustration showing BevelBorders that were
- * constructed with this method]" />
+ * constructed with this method]" /></p>
*
* @param bevelType the desired appearance of the border. The value
* must be either {@link javax.swing.border.BevelBorder#RAISED}
*
* <p><img src="../border/doc-files/BevelBorder-3.png" width="500"
* height="150" alt="[An illustration showing BevelBorders that
- * were constructed with this method]" />
+ * were constructed with this method]" /></p>
*
* @param bevelType the desired appearance of the border. The value
* must be either {@link javax.swing.border.BevelBorder#RAISED}
*
* <p><img src="../border/doc-files/EmptyBorder-1.png"
* width="290" height="200"
- * alt="[An illustration of EmptyBorder]" />
+ * alt="[An illustration of EmptyBorder]" /></p>
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
*
* <p><img src="../border/doc-files/EtchedBorder-1.png" width="500"
* height="200" alt="[An illustration of the two EtchedBorder
- * variants]" />
+ * variants]" /></p>
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
*
* <p><img src="../border/doc-files/EtchedBorder-1.png"
* width="500" height="200" alt="[An illustration of the two
- * EtchedBorder variants]" />
+ * EtchedBorder variants]" /></p>
*
* @param etchType the desired appearance of the border. The value
* must be either {@link javax.swing.border.EtchedBorder#RAISED}
*
* <p><img src="../border/doc-files/EtchedBorder-2.png" width="500"
* height="200" alt="[An illustration that shows which pixels get
- * painted in what color]" />
+ * painted in what color]" /></p>
*
* @param etchType the desired appearance of the border. The value
* must be either {@link javax.swing.border.EtchedBorder#RAISED}
* such as the borders provided by this class.
*
* <p><img src="../border/doc-files/LineBorder-1.png" width="500"
- * height="200" alt="[An illustration of two LineBorders] />
+ * height="200" alt="[An illustration of two LineBorders]" /></p>
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
* such as the borders provided by this class.
*
* <p><img src="../border/doc-files/MatteBorder-1.png" width="500"
- * height="150" alt="[An illustration of two MatteBorders] />
+ * height="150" alt="[An illustration of two MatteBorders]" /></p>
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
*
* <p><img src="../border/doc-files/MatteBorder-2.png" width="500"
* height="150" alt="[A picture of a MatteBorder made by this
- * constructor]" />
+ * constructor]" /></p>
*
* @param top the width of the border at its top edge.
* @param left the width of the border at its left edge.
*
* <p><img src="../border/doc-files/MatteBorder-4.png" width="500"
* height="150" alt="[A picture of a MatteBorder made by this
- * constructor]" />
+ * constructor]" /></p>
*
* @param top the width of the border at its top edge.
* @param left the width of the border at its left edge.
*
* <p><img src="../border/doc-files/MatteBorder-6.png" width="500"
* height="150" alt="[A picture of a MatteBorder made by this
- * constructor]" />
+ * constructor]" /></p>
*
* @param tileIcon an icon for tiling the border area.
*/
*
* <p><img src="doc-files/ComponentUI-1.png" width="700" height="550"
* alt="[UML diagram illustrating the architecture for pluggable
- * look and feels]" />
+ * look and feels]" /></p>
*
* <p>Components such as {@link javax.swing.JSlider} do not directly
* implement operations related to the look and feel of the user
* services. Soon before the end of its lifecycle, the
* <code>ComponentUI</code> will receive an {@link #uninstallUI}
* message, at which time the <code>ComponentUI</code> is expected to
- * undo any changes.
+ * undo any changes.</p>
*
* <p>Note that the <code>ui</code> of a <code>JComponent</code>
* changes whenever the user switches between look and feels. For
* example, the <code>ui</code> property of a <code>JSlider</code>
* could change from an instance of <code>MetalSliderUI</code> to an
* instance of <code>FooSliderUI</code>. This switch can happen at any
- * time, but it will always be performed from inside the Swing thread.
+ * time, but it will always be performed from inside the Swing thread.</p>
*
* @author Sascha Brawer (brawer@dandelis.ch)
*/
* The delegate object then receives an <code>installUI</code>
* message.
*
- * <p>This method should perform the following tasks:
- *
- * <ul><li>Set visual properties such as borders, fonts, colors, or
- * icons. However, no change should be performed for those
- * properties whose values have been directly set by the client
- * application. To allow the distinction, LookAndFeels are expected
- * to use values that implement the {@link UIResource} marker
- * interface, such as {@link BorderUIResource} or {@link
- * ColorUIResource}.</li>
+ * <p>This method should perform the following tasks:</p>
*
+ * <ul>
+ * <li>Set visual properties such as borders, fonts, colors, or
+ * icons. However, no change should be performed for those
+ * properties whose values have been directly set by the client
+ * application. To allow the distinction, LookAndFeels are expected
+ * to use values that implement the {@link UIResource} marker
+ * interface, such as {@link BorderUIResource} or {@link
+ * ColorUIResource}.</li>
* <li>If necessary, install a {@link java.awt.LayoutManager}.</li>
- *
* <li>Embed custom sub-components. For instance, the UI delegate
- * for a {@link javax.swing.JSplitPane} might install a special
- * component for the divider.</li>
- *
+ * for a {@link javax.swing.JSplitPane} might install a special
+ * component for the divider.</li>
* <li>Register event listeners.</li>
- *
* <li>Set up properties related to keyborad navigation, such as
- * mnemonics or focus traversal policies.</li></ul>
+ * mnemonics or focus traversal policies.</li>
+ * </ul>
*
* @param c the component for which this delegate will provide
* services.
* <code>UndoableEdits</code>.
*
* <p>The use of a <code>CompoundEdit</code> is divided in two separate
- * phases.
- *
- * <ol><li>In the first phase, the <code>CompoundEdit</code> is
- * initialized. After a new instance of <code>CompoundEdit</code> has
- * been created, {@link #addEdit(UndoableEdit)} is called for each
- * element of the compound. To terminate the initialization phase,
- * call {@link #end()}.</li>
+ * phases.</p>
*
+ * <ol>
+ * <li>In the first phase, the <code>CompoundEdit</code> is
+ * initialized. After a new instance of <code>CompoundEdit</code> has
+ * been created, {@link #addEdit(UndoableEdit)} is called for each
+ * element of the compound. To terminate the initialization phase,
+ * call {@link #end()}.</li>
* <li>In the second phase, the the <code>CompoundEdit</code> can be
- * used, typically by invoking {@link #undo()} and {@link
- * #redo()}.</li></ol>
+ * used, typically by invoking {@link #undo()} and
+ * {@link #redo()}.</li>
+ * </ol>
*
* @author Andrew Selkirk (aselkirk@sympatico.ca)
* @author Sascha Brawer (brawer@dandelis.ch)
/**
* A helper class, making it easy to support undo and redo.
*
- * <p>The following example shows how to use this class.
+ * <p>The following example shows how to use this class.</p>
*
- * <pre> Foo foo; // class Foo implements {@link StateEditable}
- * StateEdit edit;
+ * <pre>
+ * Foo foo; // class Foo implements {@link StateEditable}
+ * StateEdit edit;
*
- * edit = new StateEdit(foo, "Name Change");
- * foo.setName("Jane Doe");
- * edit.end();
- * undoManager.addEdit(edit);</pre>
+ * edit = new StateEdit(foo, "Name Change");
+ * foo.setName("Jane Doe");
+ * edit.end();
+ * undoManager.addEdit(edit);
+ * </pre>
*
* <p>If <code>Foo</code>’s implementation of {@link
* StateEditable} considers the name as part of the editable state,
* the user can now choose “Undo Name Change” or
* “Redo Name Change” from the respective menu. No
- * further undo support is needed from the application.
+ * further undo support is needed from the application.</p>
*
- * <p>The following explains what happens in the example.
- *
- * <p><ol><li>When a <code>StateEdit</code> is created, the associated
- * {@link StateEditable} gets asked to store its state into a hash
- * table, {@link #preState}.</li>
+ * <p>The following explains what happens in the example.</p>
*
+ * <ol>
+ * <li>When a <code>StateEdit</code> is created, the associated
+ * {@link StateEditable} gets asked to store its state into a hash
+ * table, {@link #preState}.</li>
* <li>The application will now perform some changes to the edited
- * object. This typically happens by invoking methods on the edited
- * object.</li>
- *
+ * object. This typically happens by invoking methods on the edited
+ * object.</li>
* <li>The editing phase is terminated by invoking the {@link #end()}
- * method of the <code>StateEdit</code>. The <code>end()</code> method
- * does two things.
- *
- * <ul><li>The edited object receives a second request for storing
- * its state. This time, it will use a different hash table, {@link
- * #postState}.</li>
- *
- * <li>To increase efficiency, the <code>StateEdit</code> now removes
- * any entries from {@link #preState} and {@link #postState} that have
- * the same key, and whose values are equal. Equality is determined
- * by invoking the <code>equals</code> method inherited from
- * {@link java.lang.Object}.</li></ul></li>
+ * method of the <code>StateEdit</code>. The <code>end()</code> method
+ * does two things.
*
+ * <ul>
+ * <li>The edited object receives a second request for storing
+ * its state. This time, it will use a different hash table, {@link
+ * #postState}.</li>
+ * <li>To increase efficiency, the <code>StateEdit</code> now removes
+ * any entries from {@link #preState} and {@link #postState} that have
+ * the same key, and whose values are equal. Equality is determined
+ * by invoking the <code>equals</code> method inherited from
+ * {@link java.lang.Object}.</li>
+ * </ul></li>
* <li>When the user later chooses to undo the <code>StateEdit</code>,
* the edited object is asked to {@linkplain StateEditable#restoreState
* restore its state} from the {@link #preState} table. Similarly,
* when the user chooses to <i>redo</i> the <code>StateEdit</code>,
* the edited object gets asked to restore its state from the {@link
- * #postState}.</li></ol>
+ * #postState}.</li>
+ * </ol>
*
* @author Andrew Selkirk (aselkirk@sympatico.ca)
* @author Sascha Brawer (brawer@dandelis.ch)
projects / gcc.git / commitdiff