stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8025824: [cleanup] Fix tidy errors and warnings in preformatted HTML files related to 2d/awt/swing

Browse Source 
Reviewed-by: anthony, alexsch
This commit is contained in:
Yuri Nesterenko 2013-10-14 11:47:27 +04:00
parent a076cb06a6
commit ca0d6ea6f7
40 changed files with 161 additions and 158 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
jdk/src/macosx/classes/com/apple/eawt/event/package.html
View File

@ -1,5 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title></title>
</head>
<body bgcolor="white">
Classes for receiving gesture events.

2
jdk/src/macosx/classes/com/apple/eawt/package.html
View File

@ -1,5 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title></title>
</head>
<body bgcolor="white">
Provides classes for integrating Java applications with the native application environment.

1
jdk/src/share/classes/java/awt/color/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides classes for color spaces. It contains an

1
jdk/src/share/classes/java/awt/datatransfer/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides interfaces and classes for transferring data

15
jdk/src/share/classes/java/awt/dnd/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Drag and Drop is a direct manipulation gesture found in many Graphical
@ -51,18 +52,18 @@ states (not entirely sequentially):
associated with some presentation
element (<code>Component</code>) in the GUI, to initiate a Drag and Drop of
some potentially <code>Transferable</code> data.
<P>
<br><br>
<LI>1 or more <code>DropTarget</code>(s) come into/go out of
existence, associated
with presentation elements in the GUI (Components), potentially
capable of consuming <code>Transferable</code> data types.
<P>
<br><br>
<LI> A <code>DragGestureRecognizer</code> is
obtained from the <code>DragSource</code> and is
associated with a <code>Component</code> in order
to track and identify any Drag
initiating gesture by the user over the <code>Component</code>.
<P>
<br><br>
<LI> A user makes a Drag gesture over the <code>Component</code>,
which the registered
<code>DragGestureRecognizer</code> detects, and notifies its
@ -76,13 +77,13 @@ contains the abstract class <code>MouseDragGestureRecognizer</code> for
recognizing mouse device gestures. Other abstract subclasses may be
provided by the platform to support other input devices or
particular <code>Component</code> class semantics.
<P>
<br><br>
<LI> The <code>DragGestureListener</code> causes the
<code>DragSource</code> to initiate the Drag
and Drop operation on behalf of the user, perhaps animating the
GUI Cursor and/or rendering an <code>Image</code> of the item(s) that are the
subject of the operation.
<P>
<br><br>
<LI> As the user gestures navigate over <code>Component</code>(s)
in the GUI with
associated <code>DropTarget</code>(s), the <code>DragSource</code>
@ -111,11 +112,11 @@ as follows:
<UL>
<LI> By the transfer "operation" selected by the user, and supported by
both the <code>DragSource</code> and <code>DropTarget</code>: Copy, Move or Reference(link).
<P>
<br><br>
<LI> By the intersection of the set of data types provided by the
<code>DragSource</code> and the set of data types comprehensible by the
<code>DropTarget</code>.
<P>
<br><br>
<LI>When the user terminates the drag operation, normally resulting in a
successful Drop, both the <code>DragSource</code> and <code>DropTarget</code>
receive

12
jdk/src/share/classes/java/awt/doc-files/AWTThreadIssues.html
View File

@ -23,7 +23,11 @@
questions.
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title></title>
</head>
<body bgcolor=white>
<h1 align=center>AWT Threading Issues</h1>
@ -81,13 +85,13 @@ this machinery are as follows:
dispatched:
<ul>
<li> Sequentially.
<dd> That is, it is not permitted that several events from
this queue are dispatched simultaneously.
<dl><dd> That is, it is not permitted that several events from
this queue are dispatched simultaneously. </dd></dl>
<li> In the same order as they are enqueued.
<dd> That is, if <code>AWTEvent</code>&nbsp;A is enqueued
<dl><dd> That is, if <code>AWTEvent</code>&nbsp;A is enqueued
to the <code>EventQueue</code> before
<code>AWTEvent</code>&nbsp;B then event B will not be
dispatched before event A.
dispatched before event A.</dd></dl>
</ul>
<li> There is at least one alive non-daemon thread while there is at
least one displayable AWT or Swing component within the

38
jdk/src/share/classes/java/awt/doc-files/DesktopProperties.html
View File

@ -23,7 +23,11 @@
questions.
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title></title>
</head>
<body bgcolor=white>
<h1 align=center>AWT Desktop Properties</h1>
@ -51,8 +55,8 @@ unavailable for any reason, the implementation will return
<p>
The following table summarizes the desktop properties documented
here, and their value types.
<p>
<table align="center" border="0" cellspacing="0" cellpadding="2" width="%95
<br><br>
<table align="center" border="0" cellspacing="0" cellpadding="2"
summary="Standard AWT Desktop Properties">
<tr bgcolor="#ccccff">
<th valign="TOP" align="LEFT">Property Name</th>
@ -60,17 +64,17 @@ here, and their value types.
<th valign="TOP" align="LEFT">Summary Description</th>
</tr>
<tr>
<td valign="TOP"><A href=#awt.font.desktophints>awt.font.desktophints</A</td>
<td valign="TOP"><a href="../../util/Map.html">java.util.Map<a/></td>
<td valign="TOP">Font smoothing (text antialiasing) settings.<a/></td>
<td valign="TOP"><A href="#awt.font.desktophints">awt.font.desktophints</A></td>
<td valign="TOP"><a href="../../util/Map.html">java.util.Map</a></td>
<td valign="TOP">Font smoothing (text antialiasing) settings.</td>
</tr>
<tr>
<td valign="TOP"><A href=#"sun.awt.enableExtraMouseButtons">sun.awt.enableExtraMouseButtons</A</td>
<td valign="TOP"><a href="../../lang/Boolean.html">java.lang.Boolean<a/></td>
<td valign="TOP">Controls if mouse events from extra buttons are to be generated or not<a/></td>
<td valign="TOP"><A href="#sun.awt.enableExtraMouseButtons">sun.awt.enableExtraMouseButtons</A></td>
<td valign="TOP"><a href="../../lang/Boolean.html">java.lang.Boolean</a></td>
<td valign="TOP">Controls if mouse events from extra buttons are to be generated or not</td>
</tr>
</table>
<p>
<h2>Desktop Font Rendering Hints</h2>
<b>Desktop Property: <A name="awt.font.desktophints">"awt.font.desktophints"</A></b>
<p>
@ -84,14 +88,14 @@ This is particularly important when creating
<a href="../../../javax/swing/JComponent.html"> Swing components</a> which
are required to appear consistent with native desktop components or other
Swing components.
<p>
<h3>Basic Usage</h3>
The standard desktop property named
<b>"awt.font.desktophints"</b>
can be used to obtain the rendering hints that best match the desktop settings.
The return value is a
<a href="../../util/Map.html"> Map<a/> of
<a href="../../util/Map.html"> Map</a> of
<a href="../RenderingHints.html"> <code>RenderingHints</code></a> which
can be directly applied to a <code>Graphics2D</code>.
<p>
@ -105,7 +109,7 @@ if (map != null) {
}
</code></pre>
<h3>Advanced Usage Tips</h3>
<p>
<h4>Listening for changes</h4>
<p>
An application can listen for changes in the property
@ -161,7 +165,7 @@ RenderingHints getRenderingHints(Graphics2D g2d,
if (hintsToSave.size() == 0) {
return savedHints;
}
/* RenderingHints.keySet() returns Set<Object> */
/* RenderingHints.keySet() returns Set&lt;Object&gt; */
for (Object o : hintsToSave.keySet()) {
RenderingHints.Key key = (RenderingHints.Key)o;
Object value = g2d.getRenderingHint(key);
@ -185,17 +189,17 @@ if (map != null) {
<h3>Details</h3>
<ul>
<li>The return value will always be null or a <code>Map</code>
<p>
<br><br>
<li>If the return value is null, then no desktop properties are available,
and dynamic updates will not be available. This is a typical behaviour if
the JDK does not recognise the desktop environment, or it is one which
has no such settings. The <b>Headless</b> toolkit is one such example.
Therefore it is important to test against null before using the map.
<p>
<br><br>
<li>If non-null the value will be a <code>Map</code> of
<code>RenderingHints</code> such that every key is an instance of
<code>RenderingHints.Key</code> and the value is a legal value for that key.
<p>
<br><br>
<li>The map may contain the default value for a hint. This is
needed in the event there is a previously a non-default value for the hint
set on the <code>Graphics2D</code>. If the map did not contain
@ -204,7 +208,7 @@ the previous hint which may not correspond to the desktop setting.
<p>
An application can use <code>setRenderingHints(Map)</code> to reinitialise
all hints, but this would affect unrelated hints too.
<p>
<br><br>
<li>A multi-screen desktop may support per-screen device settings in which
case the returned value is for the default screen of the desktop.
An application may want to use the settings for the screen on

20
jdk/src/share/classes/java/awt/doc-files/FocusSpec.html
View File

@ -27,7 +27,7 @@
<html>
<head>
<title align=center>The AWT Focus Subsystem</title>
<title>The AWT Focus Subsystem</title>
</head>
<body bgcolor="white">
@ -660,16 +660,16 @@ All other applications, including pure AWT applications, will use
FocusTraversalPolicy of its own. To do so, one needs to set Container's focus
traversal policy provider property to <code>true</code> with the call to
<ul>
<blockquote>
<code>Container.setFocusTraversalPolicyProvider(boolean)</code>
</ul>
</blockquote>
To determine whether a Container is a focus traversal policy provider, the
following method should be used:
<ul>
<blockquote>
<code>Container.isFocusTraversalPolicyProvider()</code>
</ul>
</blockquote>
If focus traversal policy provider property is set on a focus cycle root, it
isn't considered a focus traversal policy provider and behaves just like any
@ -750,10 +750,10 @@ traversals. The preferred way to initiate a programmatic traversal is
to use one of the following methods on <code>KeyboardFocusManager</code>:
<ul>
<code>KeyboardFocusManager.focusNextComponent()</code>
<code>KeyboardFocusManager.focusPreviousComponent()</code>
<code>KeyboardFocusManager.upFocusCycle()</code>
<code>KeyboardFocusManager.downFocusCycle()</code>
<li><code>KeyboardFocusManager.focusNextComponent()</code>
<li><code>KeyboardFocusManager.focusPreviousComponent()</code>
<li><code>KeyboardFocusManager.upFocusCycle()</code>
<li><code>KeyboardFocusManager.downFocusCycle()</code>
</ul>
<p>
@ -1149,7 +1149,7 @@ Microsoft Windows and Solaris is as follows:
<b>Microsoft Windows</b>: The Window is moved to front and becomes the focused
Window.
<br>
</b>Solaris</b>: The Window is moved to front. In a point-to-focus focus
<b>Solaris</b>: The Window is moved to front. In a point-to-focus focus
window manager, the Window will be focused if it is now the
top-most Window under the cursor. In a click-to-focus window
manager, the Window will become the focused Window.

79
jdk/src/share/classes/java/awt/doc-files/Modality.html
View File

@ -43,7 +43,7 @@
modality features and how to use them. It contains the following sections:
</p><ul>
<li><a href="#Definitions">Definitions</a></li>
</li><li><a href="#ModalityTypes">Modality types</a></li>
<li><a href="#ModalityTypes">Modality types</a></li>
<li><a href="#ShowHideBlocking">Show/hide blocking</a></li>
<li><a href="#ModalExclusion">Modal exclusion</a></li>
<li><a href="#Related">Related AWT features</a></li>
@ -54,13 +54,13 @@
</ul>
<a name="Definitions"></a>
</p><h3>Definitions</h3>
<h3>Definitions</h3>
<p>
<u>Document</u> - a window without an owner that, together with
all its child hierarchy, may be operated on as a single self-contained
document.
Every window belongs to some document &#151; its root can be found as
Every window belongs to some document &mdash; its root can be found as
the closest ancestor window without an owner.
</p><p>
<a name="ModalBlocked"></a>
@ -73,7 +73,7 @@
<blockquote>
<hr>
<b>Warning!</b> Some window managers allow users to change the window
Z-order in an arbitrary way &#151; in that case the last requirement
Z-order in an arbitrary way &mdash; in that case the last requirement
may not be met.
<hr>
</blockquote>
@ -92,12 +92,12 @@
</p><p>
<blockquote><hr>
<b>Note</b>: Everywhere in this document the notion of "window" is equal
to a top-level window in the Java programming language &#151; in other words
to a top-level window in the Java programming language &mdash; in other words
an instance of <code>java.awt.Window</code> or any descendant class.
<hr></blockquote>
<a name="ModalityTypes"></a>
</p><h3>Modality types</h3>
<h3>Modality types</h3>
<p>
There are four supported modality types :
@ -163,11 +163,11 @@
<hr></blockquote>
<a name="ShowHideBlocking"></a>
</p><h3>Show/hide blocking</h3>
<h3>Show/hide blocking</h3>
<p>
<u>Showing the window or modeless dialog: "F"</u><br>
All the visible modal dialogs are looked through &#151; if F is from the SB
All the visible modal dialogs are looked through &mdash; if F is from the SB
of one of them, it becomes blocked by it. If there are several such
dialogs, the first shown is used. If no such dialogs exist, F remains
unblocked.
@ -185,7 +185,7 @@
dialogs outside M's SB and modal dialogs outside M's SB that do not
block M).
</ul>
</p><p>
<p>
After the modal dialog M is shown, it becomes blocked by the first shown
dialog from the first group (if there are any), all the windows from the
second one become blocked by M, and all the windows from the third group
@ -197,12 +197,12 @@
</p><p>
<u>Showing the document-modal dialog: "M"</u><br>
All the visible application- and toolkit-modal dialogs are looked
through &#151; if M is from the SB of one of them,
through &mdash; if M is from the SB of one of them,
it becomes blocked by it. If there are several such dialogs,
the first shown is used. If no such dialogs exist, M remains unblocked.
</p><p>
<u>Showing the application-modal dialog: "M"</u><br>
All the visible toolkit-modal dialogs are looked through &#151;
All the visible toolkit-modal dialogs are looked through &mdash;
if M is from the SB of one of them, it becomes blocked by it.
If there are several such dialogs, the first shown is used.
If no such dialogs exist, M remains unblocked.
@ -212,7 +212,7 @@
</p><p>
<!-- <center> -->
</p>
<table border="1" cols="5" rows="5">
<table border="1">
<caption>The Standard Blocking Matrix</caption>
<tbody><tr align="center">
<td align="center">current/shown</td>
@ -293,11 +293,10 @@
<hr>
<b>Implementation note</b>: Changing the modal exclusion type for a visible window
may have no effect until it is hidden and then shown again.
</hr>
</blockquote>
<a name="Related"</a>
</p><h3>Related AWT features</h3>
<a name="Related"></a>
<h3>Related AWT features</h3>
<p>
<u>Always-On-Top</u><br>
@ -315,16 +314,16 @@
<p>
<u>Minimizing, maximizing and closing blocked windows</u><br>
When a modal dialog blocks a window, the user may not be able to maximize or
minimize the blocked window&#151; however, the actual behavior is unspecified
minimize the blocked window&mdash; however, the actual behavior is unspecified
and platform-dependent. In any case, the user can't close the blocked window
interactively&#151; but it can be closed programmatically by calling the
interactively&mdash; but it can be closed programmatically by calling the
<code>setVisible(false)</code> or <code>dispose()</code> methods on the blocked
window.
</p>
<p>
<u>Blocked windows activations</u><br>
When the user selects a blocked window, it may be brought to the front, along
with the blocking modal dialog which would then become the active window&#151;
with the blocking modal dialog which would then become the active window&mdash;
however, the actual behavior is unspecified and platform-dependent.
</p>
<p>
@ -339,9 +338,9 @@
</li></ol>
If the modal dialog to be hidden does not have focus, the active window remains
unchanged.
</p>
<a name="Security"></a>
</p><h3>Security</h3>
<h3>Security</h3>
<p>
A special <code>AWTPermission</code>, <code>"toolkitModality"</code>,
@ -386,35 +385,35 @@
<a name="Examples"></a>
</p><h3>Examples</h3>
<table cols="2" border="0">
<table border="0">
<tbody><tr>
<td align="left" valign="center">
<td align="left" >
<ol>
<li>Frame "F" is shown<br>
<li>Document-modal dialog "D<sub>i</sub>" is shown<br>
<li>F becomes blocked by D<sub>i</sub> &#151; it's in the same document<br>
<li>F becomes blocked by D<sub>i</sub> &mdash; it's in the same document<br>
<li>Document-modal dialog "D<sub>ii</sub>" is shown<br>
<li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> &#151; it's in the
<li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> &mdash; it's in the
same document<br>
</ol>
<br>
</td>
<td align="center" valign="center">
<td align="center">
<img src="modal-example1.gif">
<br>
</td>
</tr>
<tr>
<td align="left" valign="center">
<td align="left">
<ol>
<li>Frame "F" is shown<br>
<li>Document-modal dialog "D<sub>i</sub>" is shown<br>
<li>F becomes blocked by D<sub>i</sub> &#151; it's in the same document<br>
<li>F becomes blocked by D<sub>i</sub> &mdash; it's in the same document<br>
<li>Document-modal dialog "D<sub>ii</sub>" is shown<br>
<li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> &#151;
<li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> &mdash;
it's in the same document<br>
<li>D<sub>i</sub> is hidden<br>
<li>F becomes blocked by D<sub>ii</sub> &#151; it's in the same document<br>
<li>F becomes blocked by D<sub>ii</sub> &mdash; it's in the same document<br>
</ol>
<br>
</td>
@ -424,45 +423,45 @@
</td>
</tr>
<tr>
<td align="left" valign="center">
<td align="left">
<ol>
<li>Frame "F" is shown<br>
<li>Toolkit-modal dialog "D<sub>i</sub>" is created, but not shown<br>
<li>Document-modal dialog "D<sub>ii</sub>" is shown<br>
<li>F becomes blocked by D<sub>ii</sub> &#151; it's in the same document<br>
<li>F becomes blocked by D<sub>ii</sub> &mdash; it's in the same document<br>
<li>Application-modal dialog "D<sub>iii</sub>" is shown<br>
<li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> &#151;
<li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> &mdash;
it's in the same application<br>
<li>D<sub>i</sub> is shown<br>
<li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> &#151; it's its owner<br>
<li>D<sub>iii</sub> remains unblocked &#151; it blocks D<sub>ii</sub> and
<li>D<sub>i</sub> becomes blocked by D<sub>ii</sub> &mdash; it's its owner<br>
<li>D<sub>iii</sub> remains unblocked &mdash; it blocks D<sub>ii</sub> and
D<sub>ii</sub> blocks D<sub>i</sub><br>
</ol>
<br>
</td>
<td align="center" valign="center">
<td align="center">
<img src="modal-example3.gif">
<br>
</td>
</tr>
<tr>
<td align="left" valign="center">
<td align="left">
<ol>
<li>Frame "F" is shown<br>
<li>Toolkit-modal dialog "D<sub>i</sub>" is created, but not shown<br>
<li>Document-modal dialog "D<sub>ii</sub>" is shown<br>
<li>F becomes blocked by D<sub>ii</sub> &#151; it's in the same document<br>
<li>F becomes blocked by D<sub>ii</sub> &mdash; it's in the same document<br>
<li>Application-modal dialog "D<sub>iii</sub>" is shown<br>
<li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> &#151; it's in the
<li>D<sub>ii</sub> becomes blocked by D<sub>iii</sub> &mdash; it's in the
same application<br>
<li>D<sub>i</sub> is shown<br>
<li>D<sub>iii</sub> becomes blocked by D<sub>i</sub> &#151; D<sub>i</sub>
<li>D<sub>iii</sub> becomes blocked by D<sub>i</sub> &mdash; D<sub>i</sub>
is not blocked<br>
<li>D<sub>i</sub> remains unblocked<br>
</ol>
<br>
</td>
<td align="center" valign="center">
<td align="center">
<img src="modal-example4.gif">
<br>
</td>

1
jdk/src/share/classes/java/awt/event/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides interfaces and classes for dealing with different

1
jdk/src/share/classes/java/awt/font/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides classes and interface relating to fonts. It

1
jdk/src/share/classes/java/awt/geom/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides the Java 2D classes for defining and performing operations

1
jdk/src/share/classes/java/awt/image/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides classes for creating and modifying images.

1
jdk/src/share/classes/java/awt/image/renderable/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides classes and interfaces for producing

3
jdk/src/share/classes/java/awt/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Contains all of the classes for creating user
@ -53,7 +54,7 @@ If the bounds of a Component object exceed a platform limit,
there is no way to properly arrange them within a Container object.
The object's bounds are defined by any object's coordinate
in combination with its size on a respective axis.
<p>
<h2>Additional Specification</h2>
<ul>

1
jdk/src/share/classes/java/awt/print/package.html
View File

@ -25,6 +25,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head><title></title></head>
<body bgcolor="white">
Provides classes and interfaces for a general printing API. The

13
jdk/src/share/classes/javax/print/attribute/package.html
View File

@ -1,3 +1,4 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>javax.print.attribute package</title>
@ -30,7 +31,6 @@ questions.
Provides classes and interfaces
that describe the types of Java<sup><font size="-2">TM</font></sup> Print
Service attributes and how they can be collected into attribute sets.
<P>
<H3>What is an Attribute?</H3>
When setting up a print job,
a client specifies two things:
@ -71,7 +71,6 @@ of the results of a print job. The print job determines the manner in
which it achieves the results specified by the processing instructions.
Representing processing instructions as descriptive items
provides more flexibility for implementing print jobs.
<P>
<h4>Attribute Categories and Values</h4>
Each printer has a set of capabilities, such as the ability to print on
different paper sizes or the ability to print more than one copy. Each of
@ -222,7 +221,6 @@ one concrete implementation of each of the attribute set subinterfaces:
All of these classes extend <A HREF="HashAttributeSet.html">HashAttributeSet</A>
and enforce the restriction that the attribute set is only allowed to contain
the corresponding kind of attribute.
<P>
<H3>Attribute Class Design</H3>
An attribute value is a small, atomic data item,
such as an integer or an enumerated value. The Java Print Service API
@ -299,8 +297,8 @@ certain contexts also implements one or more subinterfaces of
<code>Attribute</code>. Most attribute classes also extend the appropriate
abstract syntax class to get the implementation. Consider the
<code>Sides</code> attribute class:
<pre>
<blockquote>
<pre>
public class Sides
extends EnumSyntax
implements DocAttribute, PrintRequestAttribute, PrintJobAttribute
@ -311,8 +309,8 @@ public class Sides
}
...
}
</blockquote>
</pre>
</blockquote>
<p>
Since every attribute class implements <code>Attribute</code>, every attribute
class must provide an implementation for the
@ -363,9 +361,8 @@ because print-request attributes are the types of attributes that
client usually specifies. This example demonstrates creating an attribute
set of print-request attributes and locating a printer that can
print the document according to the specified attributes:
<p>
<pre>
<blockquote>
<pre>
FileInputStream psStream;
try {
@ -392,8 +389,8 @@ if (services.length > 0) {
job.print(myDoc, aset);
} catch (PrintException pe) {}
}
</blockquote>
</pre>
</blockquote>
<P>
Please note: In the javax.print APIs, a null reference parameter to methods
is incorrect unless explicitly documented on the method as having a meaningful

3
jdk/src/share/classes/javax/print/attribute/standard/package.html
View File

@ -1,3 +1,4 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>javax.print.attribute.standard package</title>
@ -199,7 +200,6 @@ never appear in attribute sets,
so there is no restricted <A HREF="../AttributeSet.html">
AttributeSet</A>
subinterface for them.
<P>
<H4>Attribute Table</H4>
The table below lists all the printing attributes.
@ -213,7 +213,6 @@ the column marked "SupportedValuesAttribute"
lists the supported-values attribute class, if any,
with which a print service
indicates the supported values for that attribute category.
<P>
<TABLE BORDER=1 CELLPADDING=2 CELLSPACING=1 SUMMARY="Lists all printing attributes as described in above text">
<TR BGCOLOR="#E5E5E5">
<TH VALIGN="bottom">Attribute Class</TH>

3
jdk/src/share/classes/javax/print/event/package.html
View File

@ -1,3 +1,4 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>javax.print.event package</title>
@ -30,7 +31,7 @@ questions.
Package javax.print.event contains event classes and listener interfaces.
<p>
They may be used to monitor both print services (such as printers going
on-line & off-line), and the progress of a specific print job.
on-line &amp; off-line), and the progress of a specific print job.
<P>
Please note: In the javax.print APIs, a null reference parameter to methods
is incorrect unless explicitly documented on the method as having a meaningful

8
jdk/src/share/classes/javax/print/package.html
View File

@ -1,3 +1,4 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>javax.print package</title>
@ -52,7 +53,7 @@ such as IPP printers or JINI printers, a print-service provider can write
implementations of <code>PrintServiceLookup</code>. The print-service provider
can dynamically install these <code>PrintServiceLookup</code> implementations
using the
<a href="../../../technotes/guides/jar/jar.html#Service Provider">
<a href="../../../technotes/guides/jar/jar.html#Service%20Provider">
SPI JAR file specification</a>.
<h3>Attribute Definitions</h3>
@ -105,9 +106,8 @@ Service API: locating printers that can print five double-sided copies
of a Postscript document on size A4 paper, creating a print job from
one of the returned print services, and calling print.
<p>
<pre>
<blockquote>
<pre>
FileInputStream psStream;
try {
psStream = new FileInputStream("file.ps");
@ -132,8 +132,8 @@ if (services.length > 0) {
job.print(myDoc, aset);
} catch (PrintException pe) {}
}
</blockquote>
</pre>
</blockquote>
<P>
Please note: In the javax.print APIs, a null reference parameter to methods
is incorrect unless explicitly documented on the method as having a meaningful

2
jdk/src/share/classes/javax/swing/border/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

1
jdk/src/share/classes/javax/swing/colorchooser/package.html
View File

@ -25,6 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/event/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/filechooser/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/plaf/basic/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/plaf/metal/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

61
jdk/src/share/classes/javax/swing/plaf/multi/doc-files/multi_tsc.html
View File

@ -14,14 +14,14 @@ Using the Multiplexing Look and Feel
<blockquote>
<hr>
<i>
<p>
<i>
This document is based on an article
originally published in
<a href="http://java.sun.com/products/jfc/tsc/" target="_top"><em>The Swing
Connection</em></a>.
</p>
</i>
</p>
<hr>
</blockquote>
@ -43,7 +43,6 @@ the Java or Windows look and feel, for example --
and requires no modifications to work with auxiliary look and feels.
</p>
</p>
<p>
This document has the following sections:
@ -76,14 +75,12 @@ a <em>Swing Connection</em> article.
</p>
<p>
<a name="overview">
<a name="overview"></a>
<hr width=100% align=LEFT size=2>
</a>
<b>
<font color="#000080" size="+2">Overview</font>
</b>
<p></p>
<p>
@ -146,14 +143,12 @@ is called (unsurprisingly)
the Multiplexing look and feel.
<p>
<a name="howtouse">
<a name="howtouse"></a>
<hr width=100% align=LEFT size=2>
</a>
<b>
<font color="#000080" size="+2">How to Use Auxiliary Look and Feels</font>
</b>
<p></p>
<p>
It's easy to use auxiliary look and feels with Swing. To instruct
@ -204,14 +199,12 @@ of the UIs obtained from the default and auxiliary look and feels.
</p>
<p>
<a name="howtowrite">
<a name="howtowrite"></a>
<hr width=100% align=LEFT size=2>
</a>
<b>
<font color="#000080" size="+2">Tips for Writing an Auxiliary Look and Feel</font>
</b>
<p></p>
<p>
An auxiliary look and feel is like any other look and feel,
@ -252,7 +245,6 @@ the <code>javax.swing.plaf</code> package.
<font color="#000080" size="+1"><b>Dos and Don'ts</b></font>
</a>
</p>
<p></p>
<p>
The following paragraphs provide some general recommendations for developing
@ -264,22 +256,19 @@ auxiliary look and feels.
to perform all initialization,
and the <code>uninstallUI</code> method
to perform all cleanup.</b></font>
</font>
</p>
<ul>
<p>
<blockquote>
The <code>installUI</code> and <code>uninstallUI</code>
methods are invoked when a component's look and feel is set.
The <code>installUI</code> method gives the new UI object
a chance to add listeners on the component and its data model.
Similarly, the <code>uninstallUI</code> method
lets the previous UI object remove its listeners.
</p>
</ul>
</blockquote>
<p> <font color="#000080"><b>Don't extend
visual look and feels.</b></font></p>
<ul>
<p> We recommended that you <i>don't</i> implement
<blockquote>
We recommended that you <i>don't</i> implement
UI classes of an auxiliary look and feel as subclasses of the
UI classes of a visual look and feel. Why not? Because they might
accidentally inherit code that installs listeners on a component
@ -290,13 +279,13 @@ lets the previous UI object remove its listeners.
Instead, we recommend that the UI classes of an auxiliary look
and feel directly extend the abstract UI classes in the <code>javax.swing.plaf</code>
package. By using this strategy, the developer of an auxiliary
look and feel can avoid competing with the default look and feel.</p>
</ul>
look and feel can avoid competing with the default look and feel.
</blockquote>
<p> <font color="#000080"><b>Override all UI-specific methods
your UI classes inherit.</b></font>
</p>
<ul>
<p> We recommend that each UI class of
<blockquote>
We recommend that each UI class of
an auxiliary look and feel override the methods
defined in the <code>javax.swing.plaf</code>
UI classes it descends from
@ -309,15 +298,14 @@ lets the previous UI object remove its listeners.
if the
component is opaque. If a UI class from a non-visual auxiliary
look and feel does not override this method, all
opaque components appear as blank areas on the screen!</p>
</ul>
opaque components appear as blank areas on the screen!
</blockquote>
<p>
<br>
<a name="uidefaults">
<font color="#000080" size="+1"><b>Extending UIDefaults</b></font>
</a>
<p></p>
<p>In many cases, you
might want an auxiliary look and feel to be &quot;incomplete.&quot; That
@ -379,7 +367,6 @@ In the preceding example, an auxiliary look and feel named <code>MyAux</code>
<a name="defaultui">
<b><font color="#000080" size="+1">Examining Other UI Objects</font></b>
</a>
<p></p>
<p>In
rare instances, a UI object from an auxiliary look and feel
@ -395,12 +382,10 @@ In the preceding example, an auxiliary look and feel named <code>MyAux</code>
</p>
<p>
<a name="implementation">
<a name="implementation"></a>
<hr width=100% align=LEFT size=2>
</a>
<font color="#000080" size="+2"><b>How the Multiplexing Look and Feel
Is Implemented</b></font>
<p></p>
<p>
The Multiplexing look and feel
@ -437,8 +422,8 @@ all developers and users.
and feel is always the first to be created. After that, a UI object
is created from each auxiliary look and feel in the order
they are specified in the <code>swing.auxiliarylaf</code>
property.</li>
<p>
property.<br><br></li>
<li> When a method that requests information
from a UI object is invoked, the multiplexing UI object
invokes the method on all the UI objects, but returns
@ -450,8 +435,8 @@ all developers and users.
The <code>getPreferredSize</code> method
is also invoked on the UI object for each auxiliary look and feel,
but the return values are ignored.
</li>
<p>
<br><br></li>
<li> When a method that does not request information
from the UI object is invoked, the multiplexing UI object
invokes that method on all UIs --
@ -474,14 +459,12 @@ all developers and users.
<p>
<a name="custom">
<a name="custom"></a>
<hr width=100% align=LEFT size=2>
</a>
<font color="#000080" size="+2"><b>How to Provide a Custom Multiplexing Look
and Feel</b></font>
<p></p>
<p><font color="#000080" size="+2"><b></b></font>While
<p>While
we hope the behavior of the Multiplexing look and feel is
flexible enough not to require an alternative multiplexing look
and feel, Swing allows the user to specify another multiplexing look

2
jdk/src/share/classes/javax/swing/plaf/multi/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/plaf/nimbus/doc-files/properties.html
View File

@ -1,5 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title></title>
</head>
<body>
<h1 id="primaryColors">Primary Colors</h1>

10
jdk/src/share/classes/javax/swing/plaf/nimbus/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
@ -39,11 +39,11 @@ component states.
<p>Nimbus allows customizing many of its properties, including painters, by
altering the {@link javax.swing.UIDefaults} table. Here's an example:
<code><pre>
<pre>
UIManager.put("ProgressBar.tileWidth", myTileWidth);
UIManager.put("ProgressBar[Enabled].backgroundPainter", myBgPainter);
UIManager.put("ProgressBar[Enabled].foregroundPainter", myFgPainter);
</pre></code>
</pre>
<p>Per-component customization is also possible. When rendering a component,
Nimbus checks its client property named "Nimbus.Overrides". The value of this
@ -53,14 +53,14 @@ only. An optional client property, "Nimbus.Overrides.InheritDefaults" of type
Boolean, specifies whether the overriding settings should be merged with
default ones ({@code true}), or replace them ({@code false}). By default they
are merged:
<code><pre>
<pre>
JProgressBar bar = new JProgressBar();
UIDefaults overrides = new UIDefaults();
overrides.put("ProgressBar.cycleTime", 330);
...
bar.putClientProperty("Nimbus.Overrides", overrides);
bar.putClientProperty("Nimbus.Overrides.InheritDefaults", false);
</pre></code>
</pre>
<p>Colors in Nimbus are derived from a core set of
<a href="doc-files/properties.html#primaryColors">primary colors</a>. There are also

2
jdk/src/share/classes/javax/swing/plaf/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

10
jdk/src/share/classes/javax/swing/plaf/synth/doc-files/synthFileFormat.html
View File

@ -2,7 +2,7 @@
<html>
<head>
<title>Synth File Format</title>
<style>
<style type="text/css">
div.dtd-fragment {
width: 100%;
border: none;
@ -24,7 +24,7 @@ div.example {
Synth's file format (<a href="synth.dtd">dtd</a>)
allows for specifying all the pieces
necessary to create your own look and feel. A synth file is
loaded by way of the <A HREF="../../../../../javax/swing/plaf/synth/SynthLookAndFeel.html#load(java.io.InputStream, java.lang.Class)">SynthLookAndFeel.load(InputStream, Class)</a> or
loaded by way of the <A HREF="../../../../../javax/swing/plaf/synth/SynthLookAndFeel.html#load(java.io.InputStream,%20java.lang.Class)">SynthLookAndFeel.load(InputStream, Class)</a> or
<a href="../../../../../javax/swing/plaf/synth/SynthLookAndFeel.html#load(java.net.URL)">SynthLookAndFeel.load(URL)</a> methods.
The following example uses the <code>load</code> method to configure
a <code>SynthLookAndFeel</code> and sets it as the current look
@ -110,7 +110,7 @@ div.example {
style.</dd>
</dl>
<p>
A <a name="e.style">style</a> element corresponds to a
A style element corresponds to a
<code>SynthStyle</code>, with the child elements specifying
properties that apply to all states or state elements which
contain properties specific to a particular state. The following
@ -216,7 +216,6 @@ div.example {
contains at least SELECTED and PRESSED, state <code>one</code> will be
chosen, otherwise if the state is SELECTED, but not does not
contain PRESSED, state <code>two</code> will be used.
<p>
<h3>The font element</h3>
<div class="dtd-fragment">
@ -462,7 +461,6 @@ div.example {
for idref properties this will be the unique id of a
previously defined object.</dd>
</dl>
</dl>
<p>
<a href="#e.defaultsProperty">DefaultsProperty</a> elements are
used to define properties that will be placed in the
@ -738,7 +736,7 @@ div.example {
&lt;state value="SELECTED">
&lt;painter idref="stateFallbackPainter"/>
&lt;painter idref="stateButtonBackgroundPainter" method="buttonBackground"/>
&lt/state>
&lt;/state>
&lt;/style>
</pre>
</div>

1
jdk/src/share/classes/javax/swing/plaf/synth/package.html
View File

@ -27,6 +27,7 @@ questions.
-->
<title></title>
</head>
<body bgcolor="white">
<p>

2
jdk/src/share/classes/javax/swing/table/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/text/html/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/text/html/parser/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/text/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/text/rtf/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/tree/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">

2
jdk/src/share/classes/javax/swing/undo/package.html
View File

@ -25,7 +25,7 @@ Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">